Riferimento rapido all'SDK Consumer JavaScript

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

SDK consumer JavaScript: errori comuni

  • Problema: se non fornisci alla mappa JourneySharingMapView un'area visibile iniziale (centro e zoom), l'evento 'ready' della mappa potrebbe non attivarsi. Correzione: chiama mapView.map.setCenter(...) e mapView.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: aggiungi locationProvider.addListener('error', ...) e inserisci le chiamate alla libreria in blocchi try...catch. Consulta /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey.
  • Problema: le classi google.maps.journeySharing non sono disponibili, a meno che non carichi la libreria journeySharing. Correzione: aggiungi libraries=journeySharing all'URL dello script dell'API Maps JavaScript o carica le classi con await 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 authTokenFetcher che restituisca il token e expiresInSeconds. Consulta /maps/documentation/mobility/journey-sharing/on-demand/javascript/setup.

SDK consumer JavaScript: funzionalità legacy e deprecate

  • Opzioni di configurazione di indicatori e polilinee JourneySharingMapView e JourneySharingMapViewOptions (vehicleMarkerSetup, originMarkerSetup, destinationMarkerSetup, waypointMarkerSetup, anticipatedRoutePolylineSetup, takenRoutePolylineSetup e altre): ritirate. Sostituzione: opzioni MarkerCustomizationFunction e PolylineCustomizationFunction sul provider di posizione (ad esempio, vehicleMarkerCustomization). Sintomo: la rimozione è prevista in una release futura. Consulta la guida alla migrazione.
  • JourneySharingMapView.locationProvider e JourneySharingMapViewOptions.locationProvider: deprecati. Sostituzione: JourneySharingMapView.locationProviders e JourneySharingMapViewOptions.locationProviders.
  • Proprietà dell'elenco di indicatori e polilinee JourneySharingMapView (proprietà degli indicatori vehicleMarkers, originMarkers, destinationMarkers, waypointMarkers, anticipatedRoutePolylines, takenRoutePolylines e degli indicatori delle attività): deprecate. Sostituzione: callback MarkerCustomizationFunction e PolylineCustomizationFunction sul 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.