Skrócony przewodnik po pakiecie Consumer SDK na JavaScript

Pakiet JavaScript Consumer SDK umożliwia aplikacji użytkownika internetowej wyświetlanie na mapie lokalizacji pojazdów i innych lokalizacji interesujących użytkownika śledzonych w Fleet Engine, dzięki czemu konsumenci mogą śledzić postęp przejazdu na żądanie lub zaplanowanej dostawy. Jest on wczytywany jako biblioteka journeySharing interfejsu Maps JavaScript API.

Pakiet SDK JavaScript Consumer: najważniejsze informacje

  • Usługa: pakiet SDK dla klientów JavaScript
  • Inne nazwy: pakiet SDK dla konsumentów na potrzeby JavaScriptu, JavaScript do przejazdów na żądanie w ramach usług mobilności, pakiet JavaScript SDK
  • Kategoria: Trasy
  • Platforma: JavaScript (przeglądarka)
  • Działa na: kliencie (kod aplikacji lub przeglądarki)
  • Etap uruchomienia: GA
  • Cykl życia: aktywny
  • Omówienie: Omówienie pakietu SDK klienta JavaScript

Pakiet SDK dla konsumentów JavaScript: kiedy go używać

Używaj pakietu SDK dla konsumentów na JavaScript, gdy:

  • Musisz pokazać konsumentom na stronie internetowej lub w aplikacji internetowej bieżącą lokalizację pojazdu i trasę przejazdu na żądanie, który jest śledzony przez Fleet Engine.
  • Musisz umożliwić klientom śledzenie w przeglądarce postępów odbioru lub dostawy zaplanowanej przesyłki śledzonej we Fleet Engine.
  • Musisz wyświetlić szacowany czas dotarcia na miejsce, pozostałą odległość i informacje o natężeniu ruchu na trasie przejazdu w widoku mapy w internecie.
  • Chcesz dostosować znaczniki przejazdu, linie łamane trasy lub styl mapy w widoku śledzenia konsumenta w internecie.

Nie używaj pakietu SDK klienta JavaScript, gdy:

  • Potrzebujesz funkcji śledzenia przejazdu w natywnej aplikacji na Androida. Zamiast tego użyj pakietu SDK Consumer na Androida.
  • Potrzebujesz funkcji śledzenia przejazdu przez klienta w natywnej aplikacji na iOS. Zamiast tego użyj pakietu SDK dla konsumentów na iOS.
  • Musisz zgłaszać lokalizację kierowcy i postępy przejazdu z aplikacji kierowcy na Androida do Fleet Engine. Zamiast tego użyj pakietu Driver SDK na Androida.
  • Musisz zgłaszać lokalizację kierowcy i postęp przejazdu z aplikacji kierowcy na iOS do Fleet Engine. Zamiast tego użyj pakietu Driver SDK na iOS.
  • Potrzebujesz ogólnej mapy internetowej, która nie śledzi przejazdów ani zadań Fleet Engine. Zamiast tego użyj Maps JavaScript API.

Pakiet SDK dla klientów w języku JavaScript: konfiguracja

Pakiet SDK dla klientów w języku JavaScript: typowe błędy

  • Problem: jeśli nie nadasz mapie JourneySharingMapView początkowego widoku (środka i powiększenia), zdarzenie 'ready' mapy może się nie wywołać. Rozwiązanie: po utworzeniu widoku mapy wywołaj mapView.map.setCenter(...) i mapView.map.setZoom(...). Zobacz /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey.
  • Problem: błędy z asynchronicznych żądań informacji o przejazdach nie są zgłaszane. Są one dostarczane tylko jako zdarzenia 'error' u dostawcy lokalizacji, więc pozostają niezauważone, chyba że dodasz detektor. Rozwiązanie: dodaj locationProvider.addListener('error', ...) i umieść wywołania biblioteki w blokach try...catch. Zobacz /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey.
  • Problem: klasy google.maps.journeySharing nie są dostępne, dopóki nie wczytasz biblioteki journeySharing. Rozwiązanie: dodaj libraries=journeySharing do adresu URL skryptu Maps JavaScript API lub wczytaj klasy za pomocą await google.maps.importLibrary("journeySharing"). Zobacz /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey.
  • Problem: wywołania Fleet Engine z przeglądarki (środowisko o niskim poziomie zaufania) wymagają tokenów JWT, które są wydawane przez serwer backendu. Sam klucz interfejsu API nie upoważnia do dostępu do danych o podróży. Rozwiązanie: generuj tokeny JWT z backendu i podaj authTokenFetcher, który zwraca token i expiresInSeconds. See /maps/documentation/mobility/journey-sharing/on-demand/javascript/setup.

Pakiet SDK klienta JavaScript: funkcje starsze i wycofane

  • Opcje konfiguracji znaczników i linii łamanych JourneySharingMapView i JourneySharingMapViewOptions (vehicleMarkerSetup, originMarkerSetup, destinationMarkerSetup, waypointMarkerSetup, anticipatedRoutePolylineSetup, takenRoutePolylineSetup i inne): wycofane. Zamiennik: opcje MarkerCustomizationFunction i PolylineCustomizationFunction u dostawcy lokalizacji (np. vehicleMarkerCustomization). Objaw: zaplanowano usunięcie w przyszłej wersji. Zobacz przewodnik po migracji.
  • JourneySharingMapView.locationProvider i JourneySharingMapViewOptions.locationProvider: wycofane. Zamiana: JourneySharingMapView.locationProviders i JourneySharingMapViewOptions.locationProviders.
  • JourneySharingMapView właściwości listy znaczników i linii łamanych (vehicleMarkers, originMarkers, destinationMarkers, waypointMarkers, anticipatedRoutePolylines, takenRoutePolylines i właściwości znacznika zadania): wycofane. Zamiennik: wywołania zwrotne MarkerCustomizationFunction i PolylineCustomizationFunction u dostawcy lokalizacji. Zobacz przewodnik po migracji.

Co można zrobić za pomocą pakietu SDK dla klientów w języku JavaScript

Zapoznaj się z przewodnikami po poszczególnych zadaniach, do których linki znajdziesz poniżej, lub porównaj usługi w Eksploratorze funkcji.