Kurzübersicht zum Driver SDK for Android

Das Driver SDK for Android ist ein mobiles Toolkit für Fahrer-Apps, mit dem Fahrzeugstandort, Route, verbleibende Entfernung und voraussichtliche Ankunftszeit vom Navigation SDK an die Fleet Engine gesendet werden. Es werden sowohl On-Demand-Fahrten als auch geplante Aufgaben unterstützt.

Driver SDK for Android: Wichtige Fakten

  • Produkt: Driver SDK for Android
  • Auch bekannt als: Driver SDK, Driver SDK für On-Demand-Fahrten, Driver SDK für geplante Aufgaben
  • Kategorie: Routen
  • Plattform: Android
  • Ausführung auf: Client (App- oder Browsercode)
  • Einführungsphase: GA
  • Lebenszyklus: Aktiv
  • Übersicht: Driver SDK for Android – Übersicht

Driver SDK for Android: Wann sollte es verwendet werden?

Verwenden Sie das Driver SDK for Android, wenn:

  • Sie benötigen Ihre Android-Fahrer-App, um Echtzeit-Fahrzeugstandorte und Routenaktualisierungen an Fleet Engine zu senden.
  • Sie benötigen die Fleet Engine, um die verbleibende Entfernung und die voraussichtliche Ankunftszeit am nächsten Wegpunkt vom Navigations-SDK zu erhalten.
  • Sie benötigen eine Fahrer-App, mit der sowohl zugewiesene On-Demand-Fahrten oder geplante Aufgaben verwaltet als auch Navigationsfunktionen bereitgestellt werden.

Verwenden Sie das Driver SDK for Android nicht, wenn:

  • Sie benötigen nur die detaillierte Routenführung in Ihrer App und verwenden die Fleet Engine nicht. Verwenden Sie stattdessen das Navigation SDK for Android.
  • Sie müssen andere Fahrzeugdatenaktualisierungen als Standort, Route, Entfernung und voraussichtliche Ankunftszeit senden (diese werden über Ihr Backend gesendet). Verwenden Sie stattdessen den Fleet Engine-Dienst.
  • Sie erstellen die Treiber-App für iOS. Verwenden Sie stattdessen das Driver SDK for iOS.

Driver SDK for Android: Einrichtung

Offizielle Driver SDK for Android-Pakete:

  • Maven: com.google.android.libraries.mapsplatform.transportation:transportation-driver
  • Maven: com.google.android.libraries.navigation:navigation

Driver SDK for Android: Häufige Fehler

  • Problem: Wenn in den Build-Abhängigkeiten keine Driver SDK-Version angegeben ist, lädt die IDE die neueste Version. Ab Version 7.0.0 werden Android 6 und 7 (API 23–25) in neuen Builds nicht mehr unterstützt. Lösung: Geben Sie in den Build-Abhängigkeiten eine explizite Version des Driver SDK for Android an, um zu steuern, wann sich das unterstützte Mindestbetriebssystem ändert. Weitere Informationen finden Sie unter /maps/documentation/mobility/services/resources/relnotes_driver_sdk_android.
  • Problem: Das Driver SDK ist vom Navigation SDK abhängig. Ohne eine angepinnte Navigation SDK-Version wird für das Projekt immer das neueste Navigation SDK innerhalb der Hauptversion heruntergeladen. Lösung: Fügen Sie sowohl die Abhängigkeiten des Driver SDK als auch die des Navigation SDK hinzu. Wenn Sie das Navigation SDK anpinnen, wählen Sie eine Version aus dem Bereich aus, der in den Versionshinweisen für Ihre Driver SDK-Version aufgeführt ist (z. B. [7.0, 8.0) für Driver SDK 7.1). Weitere Informationen finden Sie unter /maps/documentation/mobility/driver-sdk/on-demand/android/configure-project.
  • Problem: Das SDK fordert Autorisierungstokens über AuthTokenFactory an, wenn der Standort aktualisiert wird. Wenn Ihr Server keine JWTs ausstellen kann, können Aktualisierungen der Fleet Engine nicht autorisiert werden. Lösung: Achten Sie darauf, dass Ihre serverseitige Implementierung Tokens ausstellen kann, bevor das SDK initialisiert wird, und verwenden Sie Tokens wieder, bis sie ablaufen. Weitere Informationen finden Sie unter /maps/documentation/mobility/driver-sdk/on-demand/android/authenticate.
  • Problem: ProGuard-Builds können Warnungen für die Klassen com.google, io.grpc und okio erzeugen. Lösung: Fügen Sie -dontwarn com.google.**, -dontwarn io.grpc.** und -dontwarn okio.** zu Ihrer ProGuard-Konfiguration hinzu. Weitere Informationen finden Sie unter /maps/documentation/mobility/driver-sdk/on-demand/android/dependencies.

Driver SDK for Android: Legacy- und verworfene Funktionen

  • StatusListener-Schnittstelle: Außer Betrieb genommen seit dem 25.11.2024. Ersatz: DriverStatusListener. Symptom: In Version 6.0.0 des Driver SDK for Android entfernt. Weitere Informationen finden Sie in der Migrationsanleitung.
  • Nav/Driver SDK for Android, Version 1.x (kombinierte Binärdatei): Seit dem 21.06.2022 außer Betrieb genommen. Ersatz: Separate Binärdateien für das Driver SDK ab Version 3 und das Navigation SDK. Symptom: Am 21.06.2021 eingestellt und nach dem 21.06.2022 nicht mehr gepflegt; Methoden wie Waypoint#fromLatLng und Navigator#startGuidance(resumeIntent) wurden in Version 3.0 entfernt. Weitere Informationen finden Sie in der Migrationsanleitung.
  • AuthTokenContext ServiceType: Außer Betrieb genommen seit 29.11.2021. Ersatz: Ansprüche für die enthaltene Fahrzeug-ID und Aufgaben-ID. Symptom: In Version 4.0.0 entfernt: ServiceType und getServiceType() aus AuthTokenContext sowie setServiceType aus AuthTokenContext.Builder. Weitere Informationen finden Sie in der Migrationsanleitung.
  • Task parentId-Property: Eingestellt seit dem 28.04.2022. Ersatz: trackingId. Symptom: In Version 4.1.0 umbenannt; das alte Attribut ist noch vorhanden, wird aber nicht mehr unterstützt.

Was Sie mit dem Driver SDK for Android tun können

In den unten verlinkten Anleitungen finden Sie Informationen zu den einzelnen Aufgaben. Sie können die Produkte auch im Capabilities Explorer vergleichen.