In diesem Abschnitt erfahren Sie, wie Sie das Fahrzeug auf geplante Aufgaben vorbereiten. Sie müssen alle folgenden Schritte ausführen, damit Ihr Backend ein Fahrzeug einer Aufgabe zuordnen kann.
Listener einrichten
Da das Driver SDK Aktionen im Hintergrund ausführt, können Sie mit DriverStatusListener
Benachrichtigungen auslösen, wenn bestimmte Ereignisse auftreten, z. B. Fehler, Warnungen oder Debug-Meldungen. Fehler können vorübergehend sein (z. B. BACKEND_CONNECTIVITY_ERROR
) oder dazu führen, dass Standortaktualisierungen dauerhaft beendet werden. Wenn Sie beispielsweise den Fehler VEHICLE_NOT_FOUND
erhalten, weist dies auf einen Konfigurationsfehler hin.
Das folgende Beispiel zeigt eine DriverStatusListener
-Implementierung:
class MyStatusListener implements DriverStatusListener {
/** Called when background status is updated, during actions such as location reporting. */
@Override
public void updateStatus(
StatusLevel statusLevel, StatusCode statusCode, String statusMsg, @Nullable Throwable cause) {
// Existing implementation
if (cause != null && cause instanceof StatusRuntimeException) {
if (Status.NOT_FOUND.getCode().equals(cause.getStatus().getCode())) {
// NOT_FOUND gRPC exception thrown by Fleet Engine.
}
}
}
}
DriverContextBuilder.setDriverStatusListener(new MyStatusListener());
Standortaktualisierungen aktivieren
Wenn Sie eine *VehicleReporter
-Instanz haben, aktivieren Sie Standortupdates so:
Java
DeliveryVehicleReporter reporter = ...;
reporter.enableLocationTracking();
Kotlin
val reporter = ...
reporter.enableLocationTracking()
(Optional) Aktualisierungsintervall festlegen
Standardmäßig sendet das Driver SDK Standortaktualisierungen im 10-Sekunden-Takt. Bei jedem Standortupdate wird auch angezeigt, dass das Fahrzeug online ist. Sie können dieses Intervall mit reporter.setLocationReportingInterval(long, TimeUnit)
ändern. Das unterstützte Mindestaktualisierungsintervall beträgt 5 Sekunden. Häufigere Aktualisierungen können zu langsameren Anfragen und Fehlern führen.