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
- Uwierzytelnianie: klucz interfejsu API, token internetowy JSON (JWT)
- Włącz też: Maps JavaScript API, Fleet Engine Service
- Atrybucja wykorzystania: opcjonalny (beta) identyfikator transakcji mobilności: przed utworzeniem
JourneySharingMapViewustawgoogle.maps.Settings.getInstance().experienceIdsna tablicę identyfikatorów transakcji mobilności (lub powiązanych identyfikatorów). FunkcjaexperienceIdsjest dostępna tylko w kanalev=betainterfejsu Maps JavaScript API. - Pierwsze kroki: konfigurowanie pakietu SDK klienta JavaScript
- Dokumentacja: dokumentacja pakietu SDK dla klientów w języku JavaScript
- Informacje o wersji: Informacje o wersji pakietu SDK dla konsumentów w języku JavaScript
Pakiet SDK dla klientów w języku JavaScript: produkty powiązane
- Często używane z: Fleet Engine Service, Maps JavaScript API, Driver SDK na Androida, Driver SDK na iOS
Pakiet SDK dla klientów w języku JavaScript: typowe błędy
- Problem: jeśli nie nadasz mapie
JourneySharingMapViewpoczątkowego widoku (środka i powiększenia), zdarzenie'ready'mapy może się nie wywołać. Rozwiązanie: po utworzeniu widoku mapy wywołajmapView.map.setCenter(...)imapView.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: dodajlocationProvider.addListener('error', ...)i umieść wywołania biblioteki w blokachtry...catch. Zobacz /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey. - Problem: klasy
google.maps.journeySharingnie są dostępne, dopóki nie wczytasz bibliotekijourneySharing. Rozwiązanie: dodajlibraries=journeySharingdo 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 iexpiresInSeconds. 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
JourneySharingMapViewiJourneySharingMapViewOptions(vehicleMarkerSetup,originMarkerSetup,destinationMarkerSetup,waypointMarkerSetup,anticipatedRoutePolylineSetup,takenRoutePolylineSetupi inne): wycofane. Zamiennik: opcjeMarkerCustomizationFunctioniPolylineCustomizationFunctionu dostawcy lokalizacji (np.vehicleMarkerCustomization). Objaw: zaplanowano usunięcie w przyszłej wersji. Zobacz przewodnik po migracji. JourneySharingMapView.locationProvideriJourneySharingMapViewOptions.locationProvider: wycofane. Zamiana:JourneySharingMapView.locationProvidersiJourneySharingMapViewOptions.locationProviders.JourneySharingMapViewwłaściwości listy znaczników i linii łamanych (vehicleMarkers,originMarkers,destinationMarkers,waypointMarkers,anticipatedRoutePolylines,takenRoutePolylinesi właściwości znacznika zadania): wycofane. Zamiennik: wywołania zwrotneMarkerCustomizationFunctioniPolylineCustomizationFunctionu 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.
- Dodaj linię łamaną trasy, która śledzi przejazd z Fleet Engine, do mapy na stronie internetowej lub w aplikacji mobilnej.
- Aktualizowanie postępów przejazdu na trasie na mapie na stronie internetowej lub w aplikacji mobilnej w przypadku przejazdu w Fleet Engine.
- Zmień styl dróg, linii łamanych i wielokątów na mapie, która śledzi postęp przejazdu z Fleet Engine.
- Wyświetlanie lub ukrywanie obiektów na mapie, która śledzi postęp przejazdu z Fleet Engine.
- Zmienianie stylu ikon i etykiet tekstowych na mapie, która śledzi postęp przejazdu z Fleet Engine.
- Zastosuj różne style mapy do różnych poziomów powiększenia na mapie, która śledzi postęp przejazdu z silnika floty.
- Zmienianie gęstości miejsc na mapie, która śledzi postęp przejazdu z Fleet Engine. Eksperymentalna Uwaga: obsługa definiowania stylów map w Google Cloud w pakiecie SDK dla konsumentów jest ogólnie dostępna, natomiast kontrola gęstości ciekawych miejsc to eksperymentalna funkcja definiowania stylów map w Google Cloud (obsługiwana tylko w przypadku jasnych stylów map).
- Zmień styl budynków na mapie, która śledzi postęp podróży z Fleet Engine. Wersja eksperymentalna Uwaga: obsługa definiowania stylów map w Google Cloud w pakiecie Consumer SDK jest ogólnie dostępna, natomiast dostosowywanie stylu budynków 3D i ich obrysów to eksperymentalna funkcja definiowania stylów map w Google Cloud (obsługiwana tylko w przypadku jasnych stylów map).
- Zmienianie stylu punktów orientacyjnych na mapie, która śledzi postęp przejazdu z Fleet Engine. Eksperymentalna Uwaga: obsługa definiowania stylów map w Google Cloud w pakiecie SDK dla klientów jest ogólnie dostępna, natomiast dostosowywanie ikon punktów orientacyjnych to eksperymentalna funkcja definiowania stylów map w Google Cloud (obsługiwana tylko w przypadku jasnych stylów map).
- Dostosuj znacznik na mapie, który śledzi postęp przejazdu z Fleet Engine.
- Dostosuj linię łamaną trasy na mapie, która śledzi postęp przejazdu z Fleet Engine.