Consumer SDK for Android – Kurzübersicht

Das Consumer SDK für Android ist Teil der Fleet Engine für On-Demand-Fahrten. Es bietet Schnittstellen, die Fahrtdaten modellieren und Fahrten in der Fleet Engine verfolgen, sowie Klassen zum Erstellen einer kartenbasierten Anzeige, die den Fortschritt einer Fahrt (Fahrzeugstandort, Route, voraussichtliche Ankunftszeit, verbleibende Entfernung, Verkehr) mit Nutzern in einer Android-App teilt.

Consumer SDK for Android: Wichtige Fakten

  • Produkt: Consumer SDK for Android
  • Auch bekannt als: Android Consumer SDK, Consumer SDK, Mobility Services On-demand Trips Android Consumer SDK
  • Kategorie: Routen
  • Plattform: Android
  • Ausführung auf: Client (App- oder Browsercode)
  • Einführungsphase: GA
  • Lebenszyklus: Aktiv
  • Übersicht: Consumer SDK for Android – Übersicht

Consumer SDK for Android: Wann sollte es verwendet werden?

Verwenden Sie das Consumer SDK für Android, wenn:

  • Sie möchten, dass Nutzer in Ihrer Android-App eine On-Demand-Fahrt (Fahrt, Bestellung oder Lieferung) verfolgen können, die Ihr Backend in Fleet Engine verfolgt.
  • Sie möchten den nahezu in Echtzeit aktualisierten, an die Straße angepassten Standort und die Route eines Fahrzeugs auf einer Karte in einer Android-App für Nutzer anzeigen.
  • Sie müssen die voraussichtliche Ankunftszeit am Abhol- und Zielort, die verbleibende Entfernung und die aktuelle Verkehrslage für eine Fleet Engine-Fahrt in Android anzeigen.
  • Sie müssen Fahrtmarkierungen, Routenpolylinien oder Kartenstile für eine Karte zur Fahrtenfreigabe in Android anpassen.

Verwenden Sie das Consumer SDK for Android nicht, wenn:

  • Sie benötigen die Funktion „Fahrt teilen“ für On-Demand-Fahrten in einer iOS-App. Verwenden Sie stattdessen das Consumer SDK for iOS.
  • Sie benötigen die Funktion zum Teilen von Fahrten auf einer Webseite oder die Möglichkeit, geplante Aufgaben wie Lieferungen für Nutzer zu verfolgen. Verwenden Sie stattdessen das JavaScript Consumer SDK.
  • Sie müssen den Standort des Fahrers und den Fortschritt der Fahrt über die Android-App des Fahrers melden. Verwenden Sie stattdessen das Driver SDK for Android.

Consumer SDK für Android: Einrichtung

Offizielle Consumer SDK for Android-Pakete:

  • Maven: com.google.android.libraries.mapsplatform.transportation:transportation-consumer

Consumer SDK for Android: Häufige Fehler

  • Problem: Wenn die Maps SDK-Abhängigkeit nicht auf eine explizite Version festgelegt ist, verwendet das Consumer SDK die erforderliche Mindestversion des Maps SDK. Das kann zu Problemen bei Apps führen, die auf Funktionen in späteren Maps SDK-Versionen angewiesen sind. Lösung: Deklarieren Sie in Gradle oder Maven neben transportation-consumer eine explizit definierte play-services-maps-Version. Weitere Informationen finden Sie unter /maps/documentation/mobility/journey-sharing/on-demand/android/configure-project.
  • Problem: Wenn die Freigabe der Fahrt nach dem Ende der Fahrt nicht beendet wird, führt das zu unnötigen Netzwerkanfragen an die Fleet Engine und zu Speicherlecks. Lösung: Rufen Sie JourneySharingSession.stop() auf, wenn die Fahrt nicht mehr benötigt wird, z. B. in onDestroy() oder wenn die Fahrt COMPLETE ist. Weitere Informationen finden Sie unter /maps/documentation/mobility/journey-sharing/on-demand/android/share-journey.
  • Problem: ConsumerApi.initialize() löst eine Ausnahme aus, wenn bereits eine API-Instanz vorhanden ist (2.0.0 und höher). Lösung: Rufen Sie zuerst ConsumerApi.getInstance() auf und prüfen Sie den zurückgegebenen Task, um festzustellen, ob bereits eine Instanz vorhanden ist. Weitere Informationen finden Sie unter /maps/documentation/mobility/services/resources/relnotes_consumer_sdk_android.
  • Problem: Das Consumer SDK Version 3 und niedriger unterstützt den vollständigen R8-Modus nicht. Bei Apps, die auf AGP 8.0 oder höher ausgerichtet sind, können Build- oder Laufzeitprobleme auftreten. Lösung: Legen Sie android.enableR8.fullMode=false fest, wenn Sie AGP 8.0 oder höher verwenden, und verwenden Sie AGP 7.3 oder höher mit Kotlin 2.0 für das Consumer SDK 3.0 oder höher. Weitere Informationen finden Sie unter /maps/documentation/mobility/journey-sharing/on-demand/android/migration-guide-v3.

Consumer SDK for Android: ältere und eingestellte Funktionen

  • ConsumerTrip, ConsumerTripCallback, ConsumerTripManager, ConsumerTripOptions: Außer Betrieb genommen seit 15.09.2023. Ersatz: TripModel, TripModelCallback, TripModelManager, TripModelOptions. Weitere Informationen finden Sie in der Migrationsanleitung.
  • Trip-Klasse und Trip.TripStatus- / Trip.TripType-Annotationen (und TripInfo#getTripStatus(), TripInfo#getTripType(), TripModelCallback#onTripStatusUpdated): Eingestellt seit dem 15.09.2023. Ersatz: TripInfo.TripStatus / TripInfo.TripType, TripInfo#getCurrentTripStatus(), TripInfo#getCurrentTripType(), TripModelCallback#onTripStatusUpdate. Weitere Informationen finden Sie in der Migrationsanleitung.
  • MarkerStyleOptions und PolylineStyleOptions: Seit dem 30.11.2021 außer Betrieb genommen. Ersatz: MarkerOptions und PolylineOptions (gemeinsam mit dem Maps SDK verwendet). Symptom: Das Consumer SDK wendet pro Markierungs- oder Polylinientyp einen eigenen Standardstil an, nicht die Standardeinstellungen von MarkerOptions. Weitere Informationen finden Sie in der Migrationsanleitung.
  • Privater Repository-Verteilungskanal: Verworfen. Ersatz: Google Maven-Repository (Versionen 2.1.0 und höher). Weitere Informationen finden Sie in der Migrationsanleitung.

Möglichkeiten mit dem Consumer SDK für Android

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