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
- Authentifizierung: JSON-Webtoken (JWT), API-Schlüssel
- Auch aktivieren: Fleet Engine Service, Maps SDK for Android
- Erste Schritte: Consumer SDK für Android einrichten
- Referenz: Consumer SDK for Android – Referenz
- Richtlinien: Richtlinien für das Consumer SDK for Android
- Versionshinweise: Versionshinweise zum Consumer SDK for Android
Offizielle Consumer SDK for Android-Pakete:
- Maven:
com.google.android.libraries.mapsplatform.transportation:transportation-consumer
Consumer SDK for Android: ähnliche Produkte
- Häufig verwendet mit: Fleet Engine Service, Driver SDK for Android, Maps SDK for Android
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-consumereine explizit definierteplay-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. inonDestroy()oder wenn die FahrtCOMPLETEist. 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 zuerstConsumerApi.getInstance()auf und prüfen Sie den zurückgegebenenTask, 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=falsefest, 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 undTrip.TripStatus- /Trip.TripType-Annotationen (undTripInfo#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.MarkerStyleOptionsundPolylineStyleOptions: Seit dem 30.11.2021 außer Betrieb genommen. Ersatz:MarkerOptionsundPolylineOptions(gemeinsam mit dem Maps SDK verwendet). Symptom: Das Consumer SDK wendet pro Markierungs- oder Polylinientyp einen eigenen Standardstil an, nicht die Standardeinstellungen vonMarkerOptions. 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.
- Fügen Sie eine anpassbare, interaktive Karte hinzu, auf der der Fortschritt einer Fahrt von Fleet Engine zu einer mobilen App verfolgt wird.
- Fügen Sie eine Polylinie für die Route hinzu, die eine Fahrt von Fleet Engine zu einer Karte auf einer Webseite oder in einer mobilen App verfolgt.
- Aktualisieren Sie den Fortschritt einer Fahrt entlang einer Route auf einer Karte auf einer Webseite oder in einer mobilen App für eine Fleet Engine-Fahrt.
- Stil von Straßen, Polylinien und Polygonen auf einer Karte ändern, auf der der Fortschritt einer Fahrt von Fleet Engine verfolgt wird
- Kartenelemente auf einer Karte ein- oder ausblenden, auf der der Fortschritt einer Fahrt von Fleet Engine verfolgt wird.
- Stil von Symbolen und Textlabels auf einer Karte ändern, auf der der Fortschritt einer Fahrt von Fleet Engine verfolgt wird
- Sie können verschiedene Kartenstile auf verschiedene Zoomstufen einer Karte anwenden, auf der der Fortschritt einer Fahrt von Fleet Engine verfolgt wird.
- Dichte der Orte auf einer Karte ändern, auf der der Fortschritt einer Fahrt von Fleet Engine verfolgt wird Experimentell Hinweis: Die Unterstützung für das cloudbasierte Gestalten von Karteninhalten im Consumer SDK ist allgemein verfügbar, während die Steuerung der POI-Dichte eine experimentelle Funktion des cloudbasierten Gestaltens von Karteninhalten ist (nur bei hellen Kartenstilen unterstützt).
- Gebäudestil auf einer Karte ändern, auf der der Fortschritt einer Fahrt von Fleet Engine verfolgt wird Experimentell Hinweis: Die Unterstützung für das cloudbasierte Gestalten von Karteninhalten im Consumer SDK ist allgemein verfügbar. Die Anpassung von 3D- und Grundriss-Gebäudestilen ist jedoch eine experimentelle Funktion des cloudbasierten Gestaltens von Karteninhalten (nur bei hellen Kartenstilen unterstützt).
- Stil der Sehenswürdigkeiten auf einer Karte ändern, auf der der Fortschritt einer Fahrt von Fleet Engine verfolgt wird Experimentell Hinweis: Die Unterstützung für das cloudbasierte Gestalten von Karteninhalten im Consumer SDK ist allgemein verfügbar. Die Anpassung von Sehenswürdigkeitssymbolen ist eine experimentelle Funktion des cloudbasierten Gestaltens von Karteninhalten (nur bei hellen Kartenstilen unterstützt).
- Markierung auf einer Karte anpassen, auf der der Fortschritt einer Fahrt aus der Fleet Engine verfolgt wird
- Polylinie der Route auf einer Karte anpassen, auf der der Fortschritt einer Fahrt von Fleet Engine verfolgt wird