L'SDK consumer JavaScript consente a un'app per utenti finali basata sul web di mostrare su una mappa la posizione dei veicoli e altre località di interesse monitorate in Fleet Engine, in modo che i consumatori possano seguire l'avanzamento di una corsa on-demand o di una spedizione programmata. Viene caricata come libreria journeySharing dell'API Maps JavaScript.
SDK consumer JavaScript: informazioni chiave
- Prodotto: SDK consumer JavaScript
- Noto anche come: SDK consumer per JavaScript, JavaScript per corse on demand di servizi di mobilità, SDK JavaScript
- Categoria: Percorsi
- Piattaforma: JavaScript (browser)
- Esecuzione su: client (codice dell'app o del browser)
- Fase di lancio: GA
- Ciclo di vita: Attivo
- Panoramica: Panoramica dell'SDK Consumer JavaScript
SDK Consumer JavaScript: quando utilizzarlo
Utilizza l'SDK Consumer per JavaScript quando:
- Devi mostrare ai consumatori la posizione in tempo reale e il percorso di un veicolo per una corsa on demand monitorata da Fleet Engine, in una pagina web o in un'app web.
- Devi consentire ai consumatori di seguire in un browser l'avanzamento del ritiro o della consegna di una spedizione programmata monitorata in Fleet Engine.
- Devi mostrare l'orario di arrivo stimato, la distanza rimanente e il traffico in tempo reale sul percorso di un viaggio in una visualizzazione mappa basata sul web.
- Devi personalizzare gli indicatori di corsa, le polilinee del percorso o lo stile di mappa in una visualizzazione di monitoraggio dei consumatori web.
Non utilizzare l'SDK Consumer per JavaScript quando:
- Hai bisogno di un'esperienza utente di monitoraggio del percorso all'interno di un'app per Android nativa. Utilizza invece l'SDK Consumer per Android.
- Hai bisogno di un'esperienza utente di monitoraggio del percorso all'interno di un'app per iOS nativa. Utilizza invece l'SDK Consumer per iOS.
- Devi segnalare la posizione del conducente e l'avanzamento della corsa dall'app per Android del conducente a Fleet Engine. Utilizza invece l'SDK Driver per Android.
- Devi segnalare la posizione del conducente e l'avanzamento della corsa dall'app per iOS del conducente a Fleet Engine. Utilizza invece l'SDK Driver per iOS.
- Hai bisogno di una mappa web generica che non segua i percorsi o le attività di Fleet Engine. Utilizza invece l'API Maps JavaScript.
SDK consumer JavaScript: configurazione
- Autenticazione: chiave API, JSON Web Token (JWT)
- Abilita anche: API Maps JavaScript, servizio Fleet Engine
- Attribuzione dell'utilizzo: ID transazione di mobilità facoltativo (beta): imposta
google.maps.Settings.getInstance().experienceIdssu un array di ID transazione di mobilità (o ID correlati) prima di creare unJourneySharingMapView.experienceIdsè disponibile solo nel canalev=betadell'API Maps JavaScript. - Inizia: Configura l'SDK Consumer JavaScript
- Riferimento: Riferimento SDK Consumer JavaScript
- Note di rilascio: note di rilascio dell'SDK Consumer JavaScript
SDK consumer JavaScript: prodotti correlati
- Spesso utilizzato con: servizio Fleet Engine, API Maps JavaScript, SDK Driver per Android, SDK Driver per iOS
SDK consumer JavaScript: errori comuni
- Problema: se non fornisci alla mappa
JourneySharingMapViewun'area visibile iniziale (centro e zoom), l'evento'ready'della mappa potrebbe non attivarsi. Correzione: chiamamapView.map.setCenter(...)emapView.map.setZoom(...)dopo aver creato la visualizzazione mappa. Consulta /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey. - Problema: gli errori delle richieste asincrone di informazioni sul percorso non vengono generati. Arrivano solo come eventi
'error'sul provider di posizione, quindi passano inosservati a meno che non aggiungi un listener. Correzione: aggiungilocationProvider.addListener('error', ...)e inserisci le chiamate alla libreria in blocchitry...catch. Consulta /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey. - Problema: le classi
google.maps.journeySharingnon sono disponibili, a meno che non carichi la libreriajourneySharing. Correzione: aggiungilibraries=journeySharingall'URL dello script dell'API Maps JavaScript o carica le classi conawait google.maps.importLibrary("journeySharing"). Consulta /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey. - Problema: le chiamate a Fleet Engine dal browser (un ambiente a bassa attendibilità) richiedono i JWT emessi dal server di backend. Una chiave API da sola non autorizza l'accesso ai dati sul percorso. Soluzione: emetti i JWT dal tuo backend e fornisci un
authTokenFetcherche restituisca il token eexpiresInSeconds. Consulta /maps/documentation/mobility/journey-sharing/on-demand/javascript/setup.
SDK consumer JavaScript: funzionalità legacy e deprecate
- Opzioni di configurazione di indicatori e polilinee
JourneySharingMapVieweJourneySharingMapViewOptions(vehicleMarkerSetup,originMarkerSetup,destinationMarkerSetup,waypointMarkerSetup,anticipatedRoutePolylineSetup,takenRoutePolylineSetupe altre): ritirate. Sostituzione: opzioniMarkerCustomizationFunctionePolylineCustomizationFunctionsul provider di posizione (ad esempio,vehicleMarkerCustomization). Sintomo: la rimozione è prevista in una release futura. Consulta la guida alla migrazione. JourneySharingMapView.locationProvidereJourneySharingMapViewOptions.locationProvider: deprecati. Sostituzione:JourneySharingMapView.locationProviderseJourneySharingMapViewOptions.locationProviders.- Proprietà dell'elenco di indicatori e polilinee
JourneySharingMapView(proprietà degli indicatorivehicleMarkers,originMarkers,destinationMarkers,waypointMarkers,anticipatedRoutePolylines,takenRoutePolylinese degli indicatori delle attività): deprecate. Sostituzione: callbackMarkerCustomizationFunctionePolylineCustomizationFunctionsul provider di geolocalizzazione. Consulta la guida alla migrazione.
Cosa puoi fare con l'SDK Consumer per JavaScript
Consulta le guide collegate di seguito per ogni attività o confronta i prodotti in Capabilities Explorer.
- Aggiungi una polilinea del percorso che monitora un percorso da Fleet Engine a una mappa su una pagina web o un'app mobile.
- Aggiorna l'avanzamento della corsa lungo un percorso in una mappa su una pagina web o un'app mobile per una corsa di Fleet Engine.
- Modifica lo stile di strade, polilinee e poligoni su una mappa che monitora l'avanzamento di un percorso da Fleet Engine.
- Mostra o nascondi gli elementi della mappa su una mappa che monitora l'avanzamento di un percorso da Fleet Engine.
- Modifica lo stile delle icone e delle etichette di testo su una mappa che monitora l'avanzamento di un percorso da Fleet Engine.
- Applica stili di mappa diversi a livelli di zoom diversi su una mappa che monitora l'avanzamento di un percorso da Fleet Engine.
- Modifica la densità dei luoghi su una mappa che monitora l'avanzamento di un percorso da Fleet Engine. Sperimentale Nota: il supporto della personalizzazione delle mappe basata su cloud nell'SDK Consumer è in disponibilità generale, mentre il controllo della densità dei PDI è una funzionalità sperimentale della personalizzazione delle mappe basata su cloud (supportata solo negli stili di mappa chiari).
- Modifica lo stile degli edifici su una mappa che monitora l'avanzamento di un percorso da Fleet Engine. Sperimentale Nota: il supporto della personalizzazione delle mappe basata su cloud nell'SDK Consumer è in disponibilità generale, mentre la personalizzazione dello stile degli edifici in 3D e con impronta è una funzionalità di personalizzazione delle mappe basata su cloud sperimentale (supportata solo negli stili di mappa chiari).
- Modifica lo stile dei punti di riferimento su una mappa che monitora l'avanzamento di un percorso da Fleet Engine. Sperimentale Nota: il supporto della personalizzazione delle mappe basata su cloud nell'SDK Consumer è in disponibilità generale, mentre la personalizzazione delle icone dei punti di riferimento è una funzionalità di personalizzazione delle mappe basata su cloud sperimentale (supportata solo negli stili di mappa chiari).
- Personalizza un indicatore su una mappa che monitora l'avanzamento di un percorso da Fleet Engine.
- Personalizza la polilinea del percorso su una mappa che monitora l'avanzamento di un percorso da Fleet Engine.