Trip and Order Progress

FleetEngineTripLocationProvider class

google.maps.journeySharing.FleetEngineTripLocationProvider classe

Fornitore di posizione del viaggio.

Questo corso si estende PollingLocationProvider.

Accesso chiamando il numero const {FleetEngineTripLocationProvider} = await google.maps.importLibrary("journeySharing").
Consulta Librerie nell'API Maps JavaScript.
FleetEngineTripLocationProvider
FleetEngineTripLocationProvider(options)
Parametri: 
Crea un nuovo fornitore di servizi di localizzazione per un viaggio Fleet Engine.
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params)
Parametri: 
Valore restituito:nessuno
Funzione di personalizzazione della polilinea che colora la polilinea attiva in base alla velocità di lettura. Specifica questa funzione come FleetEngineTripLocationProviderOptions.activePolylineCustomization per visualizzare una polilinea in base al traffico per la polilinea attiva.
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION(params)
Parametri: 
Valore restituito:nessuno
Funzione di personalizzazione della polilinea che colora la polilinea rimanente in base alla velocità di lettura. Specifica questa funzione come FleetEngineTripLocationProviderOptions.remainingPolylineCustomization per eseguire il rendering di una polilinea in base al traffico per la polilinea rimanente.
tripId
Tipo:  string
L'ID del viaggio che questo fornitore di servizi di localizzazione osserva. Imposta questo campo per iniziare il monitoraggio.
Ereditato: isPolling, pollingIntervalMillis
refresh
refresh()
Parametri: nessuno
Valore restituito:  void
Aggiorna in modo esplicito la posizione monitorata.
Ereditato: addListener
error
function(event)
Argomenti: 
Evento attivato quando il fornitore di servizi di localizzazione rileva un errore.
update
function(event)
Argomenti: 
Evento attivato al termine di una richiesta di aggiornamento dei dati di Fleet Engine.
Ereditato: ispollingchange

Interfaccia FleetEngineTripLocationProviderOptions

google.maps.journeySharing.FleetEngineTripLocationProviderOptions interfaccia

Opzioni per il fornitore della posizione del viaggio.
authTokenFetcher
Fornisce token web JSON per l'autenticazione del client a Fleet Engine.
projectId
Tipo:  string
L'ID progetto del consumatore dalla console Google Cloud.
activePolylineCustomization optional
Tipo:  (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions optional
Personalizzazione applicata alla polilinea attiva. Una polilinea attiva corrisponde a una parte del percorso che il veicolo sta attualmente attraversando.

Utilizza questo campo per specificare lo stile personalizzato (ad esempio il colore della polilinea) e l'interattività (ad esempio la gestione dei clic).
  • Se viene specificato un oggetto PolylineOptions, le modifiche specificate vengono applicate alla polilinea dopo la sua creazione, sovrascrivendo le opzioni predefinite, se esistenti.
  • Se viene specificata una funzione, questa viene richiamata una volta quando viene creata la polilinea. (In questa chiamata, il parametro isNew nell'oggetto dei parametri della funzione è impostato su true.) Inoltre, questa funzione viene chiamata quando le coordinate della polilinea cambiano o quando il fornitore di servizi di localizzazione riceve dati da Fleet Engine, indipendentemente dal fatto che i dati corrispondenti a questa polilinea siano cambiati.

    Consulta TripPolylineCustomizationFunctionParams per un elenco dei parametri forniti e dei relativi utilizzi.
destinationMarkerCustomization optional
Tipo:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Personalizzazione applicata al marcatore della destinazione.

Utilizza questo campo per specificare lo stile personalizzato (ad esempio l'icona del marcatore) e l'interattività (ad esempio la gestione dei clic).
  • Se viene specificato un oggetto MarkerOptions, le modifiche specificate vengono applicate al marcatore dopo la sua creazione, sovrascrivendo le opzioni predefinite, se esistenti.
  • Se viene specificata una funzione, questa viene richiamata una volta quando viene creato il marcatore, prima che venga aggiunto alla visualizzazione della mappa. In questa chiamata, il parametro isNew nell'oggetto dei parametri della funzione è impostato su true. Inoltre, questa funzione viene chiamata quando il fornitore di servizi di localizzazione riceve dati da Fleet Engine, indipendentemente dal fatto che i dati corrispondenti a questo marcatore siano cambiati.

    Consulta la sezione TripMarkerCustomizationFunctionParams per un elenco dei parametri forniti e dei relativi utilizzi.
originMarkerCustomization optional
Tipo:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Personalizzazione applicata al marcatore di origine.

Utilizza questo campo per specificare lo stile personalizzato (ad esempio l'icona del marcatore) e l'interattività (ad esempio la gestione dei clic).
  • Se viene specificato un oggetto MarkerOptions, le modifiche specificate vengono applicate al marcatore dopo la sua creazione, sovrascrivendo le opzioni predefinite, se esistenti.
  • Se viene specificata una funzione, questa viene richiamata una volta quando viene creato il marcatore, prima che venga aggiunto alla visualizzazione della mappa. In questa chiamata, il parametro isNew nell'oggetto dei parametri della funzione è impostato su true. Inoltre, questa funzione viene chiamata quando il fornitore di servizi di localizzazione riceve dati da Fleet Engine, indipendentemente dal fatto che i dati corrispondenti a questo marcatore siano cambiati.

    Consulta la sezione TripMarkerCustomizationFunctionParams per un elenco dei parametri forniti e dei relativi utilizzi.
pollingIntervalMillis optional
Tipo:  number optional
Tempo minimo tra il recupero degli aggiornamenti della posizione in millisecondi. Se l'aggiornamento della posizione richiede più di pollingIntervalMillis, il successivo non viene avviato finché non termina quello attuale.

Se imposti questo valore su 0, gli aggiornamenti periodici della posizione vengono disattivati. Viene recuperato un nuovo aggiornamento della posizione se uno dei parametri osservati dal fornitore di servizi di localizzazione cambia.

L'intervallo di polling predefinito è 5000 millisecondi, l'intervallo minimo. Se imposti l'intervallo di polling su un valore diverso da zero inferiore, viene utilizzato 5000.
remainingPolylineCustomization optional
Tipo:  (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions optional
Personalizzazione applicata alla polilinea rimanente. Una polilinea rimanente corrisponde a una parte del percorso che il veicolo non ha ancora iniziato a percorrere.

Utilizza questo campo per specificare lo stile personalizzato (ad esempio il colore della polilinea) e l'interattività (ad esempio la gestione dei clic).
  • Se viene specificato un oggetto PolylineOptions, le modifiche specificate vengono applicate alla polilinea dopo la sua creazione, sovrascrivendo le opzioni predefinite, se esistenti.
  • Se viene specificata una funzione, questa viene richiamata una volta quando viene creata la polilinea. (In questa chiamata, il parametro isNew nell'oggetto dei parametri della funzione è impostato su true.) Inoltre, questa funzione viene chiamata quando le coordinate della polilinea cambiano o quando il fornitore di servizi di localizzazione riceve dati da Fleet Engine, indipendentemente dal fatto che i dati corrispondenti a questa polilinea siano cambiati.

    Consulta TripPolylineCustomizationFunctionParams per un elenco dei parametri forniti e dei relativi utilizzi.
takenPolylineCustomization optional
Tipo:  (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions optional
Personalizzazione applicata alla polilinea acquisita. Una polilinea percorsa corrisponde a una parte del percorso che il veicolo ha già attraversato.

Utilizza questo campo per specificare lo stile personalizzato (ad esempio il colore della polilinea) e l'interattività (ad esempio la gestione dei clic).
  • Se viene specificato un oggetto PolylineOptions, le modifiche specificate vengono applicate alla polilinea dopo la sua creazione, sovrascrivendo le opzioni predefinite, se esistenti.
  • Se viene specificata una funzione, questa viene richiamata una volta quando viene creata la polilinea. (In questa chiamata, il parametro isNew nell'oggetto dei parametri della funzione è impostato su true.) Inoltre, questa funzione viene chiamata quando le coordinate della polilinea cambiano o quando il fornitore di servizi di localizzazione riceve dati da Fleet Engine, indipendentemente dal fatto che i dati corrispondenti a questa polilinea siano cambiati.

    Consulta TripPolylineCustomizationFunctionParams per un elenco dei parametri forniti e dei relativi utilizzi.
tripId optional
Tipo:  string optional
L'ID viaggio da monitorare immediatamente dopo l'istanza del fornitore di servizi di localizzazione. Se non specificato, il fornitore di servizi di localizzazione non inizia a monitorare alcun viaggio; utilizza FleetEngineTripLocationProvider.tripId per impostare l'ID e iniziare il monitoraggio.
vehicleMarkerCustomization optional
Tipo:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Personalizzazione applicata al marcatore del veicolo.

Utilizza questo campo per specificare lo stile personalizzato (ad esempio l'icona del marcatore) e l'interattività (ad esempio la gestione dei clic).
  • Se viene specificato un oggetto MarkerOptions, le modifiche specificate vengono applicate al marcatore dopo la sua creazione, sovrascrivendo le opzioni predefinite, se esistenti.
  • Se viene specificata una funzione, questa viene richiamata una volta quando viene creato il marcatore, prima che venga aggiunto alla visualizzazione della mappa. In questa chiamata, il parametro isNew nell'oggetto dei parametri della funzione è impostato su true. Inoltre, questa funzione viene chiamata quando il fornitore di servizi di localizzazione riceve dati da Fleet Engine, indipendentemente dal fatto che i dati corrispondenti a questo marcatore siano cambiati.

    Consulta la sezione TripMarkerCustomizationFunctionParams per un elenco dei parametri forniti e dei relativi utilizzi.
waypointMarkerCustomization optional
Personalizzazione applicata a un indicatore di waypoint.

Utilizza questo campo per specificare lo stile personalizzato (ad esempio l'icona del marcatore) e l'interattività (ad esempio la gestione dei clic).
  • Se viene specificato un oggetto MarkerOptions, le modifiche specificate vengono applicate al marcatore dopo la sua creazione, sovrascrivendo le opzioni predefinite, se esistenti.
  • Se viene specificata una funzione, questa viene richiamata una volta quando viene creato il marcatore, prima che venga aggiunto alla visualizzazione della mappa. In questa chiamata, il parametro isNew nell'oggetto dei parametri della funzione è impostato su true. Inoltre, questa funzione viene chiamata quando il fornitore di servizi di localizzazione riceve dati da Fleet Engine, indipendentemente dal fatto che i dati corrispondenti a questo marcatore siano cambiati.

    Consulta la sezione TripWaypointMarkerCustomizationFunctionParams per un elenco dei parametri forniti e dei relativi utilizzi.

Interfaccia FleetEngineTripLocationProviderUpdateEvent

google.maps.journeySharing.FleetEngineTripLocationProviderUpdateEvent interfaccia

L'oggetto evento passato al gestore eventi quando viene attivato l'evento FleetEngineTripLocationProvider.update.
trip optional
Tipo:  Trip optional
La struttura del viaggio restituita dall'aggiornamento. Non modificabile.