Kurzübersicht zum JavaScript Consumer SDK

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

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 Sie mapView.map.setCenter(...) und mapView.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 Sie locationProvider.addListener('error', ...) hinzu und umschließen Sie Bibliotheksaufrufe mit try...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 die journeySharing-Bibliothek laden. Lösung: Fügen Sie der Skript-URL der Maps JavaScript API libraries=journeySharing hinzu oder laden Sie die Klassen mit await 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 authTokenFetcher bereit, der das Token und expiresInSeconds zurückgibt. Weitere Informationen finden Sie unter /maps/documentation/mobility/journey-sharing/on-demand/javascript/setup.

JavaScript Consumer SDK: Legacy- und eingestellte Funktionen

  • JourneySharingMapView- und JourneySharingMapViewOptions-Optionen für die Einrichtung von Markierungen und Polylinien (vehicleMarkerSetup, originMarkerSetup, destinationMarkerSetup, waypointMarkerSetup, anticipatedRoutePolylineSetup, takenRoutePolylineSetup usw.): Eingestellt. Ersatz: Die Optionen MarkerCustomizationFunction und PolylineCustomizationFunction beim Standortanbieter (z. B. vehicleMarkerCustomization). Symptom: Wird in einer zukünftigen Version entfernt. Weitere Informationen finden Sie in der Migrationsanleitung.
  • JourneySharingMapView.locationProvider und JourneySharingMapViewOptions.locationProvider: Eingestellt. Ersatz: JourneySharingMapView.locationProviders und JourneySharingMapViewOptions.locationProviders.
  • JourneySharingMapView-Markierungs- und Polylinienlisten-Eigenschaften (vehicleMarkers, originMarkers, destinationMarkers, waypointMarkers, anticipatedRoutePolylines, takenRoutePolylines und Aufgabenmarkierungs-Eigenschaften): Eingestellt. Ersatz: MarkerCustomizationFunction- und PolylineCustomizationFunction-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.