Mit dem JavaScript Consumer SDK kann eine webbasierte Verbraucher-App den Standort von Fahrzeugen und anderen Orten von Interesse, die in der Fleet Engine erfasst werden, auf einer Karte anzeigen. So können Verbraucher den Fortschritt einer On-Demand-Fahrt oder einer geplanten Sendung verfolgen. Sie wird als journeySharing-Bibliothek der Maps JavaScript API geladen.
JavaScript Consumer SDK: Wichtige Fakten
- Produkt: JavaScript Consumer SDK
- Auch bekannt als: Consumer SDK für JavaScript, JavaScript für On-Demand-Fahrten von Mobilitätsdiensten, JavaScript SDK
- Kategorie: Routen
- Plattform: JavaScript (Browser)
- Ausführung auf: Client (App- oder Browsercode)
- Einführungsphase: GA
- Lebenszyklus: Aktiv
- Übersicht: Übersicht über das JavaScript Consumer SDK
JavaScript Consumer SDK: Wann sollte es verwendet werden?
Verwenden Sie das JavaScript Consumer SDK, wenn:
- Sie müssen Nutzern den aktuellen Standort und die Route eines Fahrzeugs für eine On-Demand-Fahrt, die von der Fleet Engine erfasst wird, auf einer Webseite oder in einer Web-App anzeigen.
- Sie möchten, dass Kunden den Fortschritt der Abholung oder Lieferung einer geplanten Sendung, die in der Fleet Engine erfasst wird, in einem Browser verfolgen können.
- Sie müssen die voraussichtliche Ankunftszeit, die verbleibende Entfernung und die aktuelle Verkehrslage auf der Route für eine Fahrt in einer webbasierten Kartenansicht anzeigen.
- Sie müssen Fahrtmarkierungen, Routenpolylinien oder das Karten-Styling in einer Web-Nutzer-Tracking-Ansicht anpassen.
Verwenden Sie das JavaScript Consumer SDK nicht, wenn:
- Sie benötigen eine Funktion zur Fahrtverfolgung in einer nativen Android-App. Verwenden Sie stattdessen das Consumer SDK für Android.
- Sie benötigen eine Funktion zur Fahrtverfolgung in einer nativen iOS-App. Verwenden Sie stattdessen das Consumer SDK for iOS.
- Sie müssen den Standort des Fahrers und den Fortschritt der Fahrt über die Android-App des Fahrers an die Fleet Engine melden. Verwenden Sie stattdessen das Driver SDK for Android.
- Sie müssen den Standort des Fahrers und den Fortschritt der Fahrt über die iOS-App des Fahrers an die Fleet Engine melden. Verwenden Sie stattdessen das Driver SDK for iOS.
- Sie benötigen eine allgemeine Webkarte, die nicht den Fahrten oder Aufgaben von Fleet Engine folgt. Verwenden Sie stattdessen die Maps JavaScript API.
JavaScript Consumer SDK: Einrichtung
- Authentifizierung: API-Schlüssel, JSON Web Token (JWT)
- Auch aktivieren: Maps JavaScript API, Fleet Engine-Dienst
- Nutzungszuordnung: Optionale (Beta) Mobility-Transaktions-ID: Legen Sie
google.maps.Settings.getInstance().experienceIdsauf ein Array von Mobility-Transaktions-IDs (oder zugehörigen IDs) fest, bevor Sie eineJourneySharingMapViewerstellen.experienceIdsist nur in derv=beta-Version der Maps JavaScript API verfügbar. - Erste Schritte: JavaScript Consumer SDK einrichten
- Referenz: Referenz zum JavaScript Consumer SDK
- Versionshinweise: Versionshinweise zum JavaScript Consumer SDK
JavaScript Consumer SDK: ähnliche Produkte
- Häufig verwendet mit: Fleet Engine Service, Maps JavaScript API, Driver SDK for Android, Driver SDK for iOS
JavaScript Consumer SDK: Häufige Fehler
- Problem: Wenn Sie für die
JourneySharingMapView-Karte keinen anfänglichen Darstellungsbereich (Mittelpunkt und Zoom) festlegen, wird das'ready'-Ereignis der Karte möglicherweise nicht ausgelöst. Lösung: Rufen SiemapView.map.setCenter(...)undmapView.map.setZoom(...)auf, nachdem Sie die Kartenansicht erstellt haben. Weitere Informationen finden Sie unter /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey. - Problem: Fehler bei asynchronen Anfragen zu Fahrtdetails werden nicht ausgelöst. Sie werden nur als
'error'-Ereignisse an den Standortanbieter gesendet und bleiben daher unbemerkt, wenn Sie keinen Listener hinzufügen. Lösung: Fügen SielocationProvider.addListener('error', ...)hinzu und umschließen Sie Bibliotheksaufrufe mittry...catch-Blöcken. Weitere Informationen finden Sie unter /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey. - Problem: Die
google.maps.journeySharing-Klassen sind nur verfügbar, wenn Sie diejourneySharing-Bibliothek laden. Lösung: Fügen Sie der Skript-URL der Maps JavaScript APIlibraries=journeySharinghinzu oder laden Sie die Klassen mitawait google.maps.importLibrary("journeySharing"). Weitere Informationen finden Sie unter /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey. - Problem: Fleet Engine-Aufrufe aus dem Browser (einer Umgebung mit geringem Vertrauen) erfordern JWTs, die von Ihrem Backend-Server ausgestellt werden. Ein API-Schlüssel allein reicht nicht aus, um den Zugriff auf Fahrtdaten zu autorisieren. Lösung: Stellen Sie JWTs über Ihr Backend aus und stellen Sie einen
authTokenFetcherbereit, der das Token undexpiresInSecondszurückgibt. Weitere Informationen finden Sie unter /maps/documentation/mobility/journey-sharing/on-demand/javascript/setup.
JavaScript Consumer SDK: Legacy- und eingestellte Funktionen
JourneySharingMapView- undJourneySharingMapViewOptions-Optionen für die Einrichtung von Markierungen und Polylinien (vehicleMarkerSetup,originMarkerSetup,destinationMarkerSetup,waypointMarkerSetup,anticipatedRoutePolylineSetup,takenRoutePolylineSetupusw.): Eingestellt. Ersatz: Die OptionenMarkerCustomizationFunctionundPolylineCustomizationFunctionbeim Standortanbieter (z. B.vehicleMarkerCustomization). Symptom: Wird in einer zukünftigen Version entfernt. Weitere Informationen finden Sie in der Migrationsanleitung.JourneySharingMapView.locationProviderundJourneySharingMapViewOptions.locationProvider: Eingestellt. Ersatz:JourneySharingMapView.locationProvidersundJourneySharingMapViewOptions.locationProviders.JourneySharingMapView-Markierungs- und Polylinienlisten-Eigenschaften (vehicleMarkers,originMarkers,destinationMarkers,waypointMarkers,anticipatedRoutePolylines,takenRoutePolylinesund Aufgabenmarkierungs-Eigenschaften): Eingestellt. Ersatz:MarkerCustomizationFunction- undPolylineCustomizationFunction-Callbacks beim Standortanbieter. Weitere Informationen finden Sie in der Migrationsanleitung.
Möglichkeiten mit dem JavaScript Consumer SDK
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 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