Trip and Order Progress

Classe FleetEngineTripLocationProvider

google.maps.journeySharing.FleetEngineTripLocationProvider corso

Fornitore di dati sulla posizione dei viaggi.

Questa classe estende PollingLocationProvider.

Accedi chiamando const {FleetEngineTripLocationProvider} = await google.maps.importLibrary("journeySharing"). Consulta la sezione Librerie nell'API Maps JavaScript.

FleetEngineTripLocationProvider
FleetEngineTripLocationProvider(options)
Parametri: 
Crea un nuovo fornitore di servizi di geolocalizzazione per un viaggio di Fleet Engine.
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params)
Parametri: 
Valore restituito:nessuno
Funzione di personalizzazione del polilinea che colora il polilinea attivo in base alla lettura della velocità. Specifica questa funzione come FleetEngineTripLocationProviderOptions.activePolylineCustomization per visualizzare un polilinea sensibile al traffico per il polilinea attivo.
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 lettura della velocità. Specifica questa funzione come FleetEngineTripLocationProviderOptions.remainingPolylineCustomization per visualizzare un polilinea sensibile al traffico per il resto del polilinea.
tripId
Tipo:  string
L'ID del viaggio osservato da questo fornitore di posizione. Imposta questo campo per iniziare il monitoraggio.
Ereditato: isPolling, pollingIntervalMillis
refresh
refresh()
Parametri: nessuno
Valore restituito:void
Aggiorna esplicitamente la posizione monitorata.
Ereditato: addListener
error
function(event)
Argomenti: 
Evento attivato quando il fornitore di servizi di geolocalizzazione rileva un errore.
update
function(event)
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 in Fleet Engine.
projectId
Tipo:  string
L'ID progetto del consumatore dalla console Google Cloud.
activePolylineCustomization optional
Tipo:  (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions optional
Personalizzazione applicata al polilinea attivo. Una polilinea attiva corrisponde a una parte del percorso che il veicolo sta attraversando.

Utilizza questo campo per specificare stili personalizzati (ad esempio il colore del polilinea) e interattività (ad esempio la gestione dei clic).
  • Se viene specificato un oggetto PolylineOptions, le modifiche in esso specificate vengono applicate al polilinea dopo la sua creazione, sovrascrivendo le opzioni predefinite, se esistenti.
  • Se viene specificata una funzione, viene richiamata una volta quando viene creato il polilinea. In questa chiamata, il parametro isNew nell'oggetto parametri della funzione è impostato su true. Inoltre, questa funzione viene invocata quando le coordinate del polilinea cambiano o quando il fornitore di servizi di geolocalizzazione riceve dati da Fleet Engine, indipendentemente dal fatto che i dati corrispondenti a questo 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 all'indicatore della destinazione.

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

    Consulta TripMarkerCustomizationFunctionParams per un elenco dei parametri forniti e dei relativi utilizzi.
originMarkerCustomization optional
Tipo:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Personalizzazione applicata all'indicatore di origine.

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

    Consulta 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 secondi, l'aggiornamento successivo non viene avviato finché non è terminato quello corrente.

Se imposti questo valore su 0, gli aggiornamenti della posizione ricorrenti vengono disattivati. Viene recuperato un nuovo aggiornamento della posizione se uno dei parametri osservati dal provider di posizione 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 il valore 5000.
remainingPolylineCustomization optional
Tipo:  (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions optional
Personalizzazione applicata al 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 stili personalizzati (ad esempio il colore del polilinea) e interattività (ad esempio la gestione dei clic).
  • Se viene specificato un oggetto PolylineOptions, le modifiche in esso specificate vengono applicate al polilinea dopo la sua creazione, sovrascrivendo le opzioni predefinite, se esistenti.
  • Se viene specificata una funzione, viene richiamata una volta quando viene creato il polilinea. In questa chiamata, il parametro isNew nell'oggetto parametri della funzione è impostato su true. Inoltre, questa funzione viene invocata quando le coordinate del polilinea cambiano o quando il fornitore di servizi di geolocalizzazione riceve dati da Fleet Engine, indipendentemente dal fatto che i dati corrispondenti a questo 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 già percorsa dal veicolo.

Utilizza questo campo per specificare stili personalizzati (ad esempio il colore del polilinea) e interattività (ad esempio la gestione dei clic).
  • Se viene specificato un oggetto PolylineOptions, le modifiche in esso specificate vengono applicate al polilinea dopo la sua creazione, sovrascrivendo le opzioni predefinite, se esistenti.
  • Se viene specificata una funzione, viene richiamata una volta quando viene creato il polilinea. In questa chiamata, il parametro isNew nell'oggetto parametri della funzione è impostato su true. Inoltre, questa funzione viene invocata quando le coordinate del polilinea cambiano o quando il fornitore di servizi di geolocalizzazione riceve dati da Fleet Engine, indipendentemente dal fatto che i dati corrispondenti a questo 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'inizializzazione del provider di posizione. Se non specificato, il fornitore di servizi di geolocalizzazione non avvia il monitoraggio di nessun viaggio. Utilizza FleetEngineTripLocationProvider.tripId per impostare l'ID e iniziare il monitoraggio.
vehicleMarkerCustomization optional
Tipo:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Personalizzazione applicata all'indicatore del veicolo.

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

    Consulta 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 stili personalizzati (ad es. l'icona del marker) e interattività (ad es. la gestione dei clic).
  • Se viene specificato un oggetto MarkerOptions, le modifiche in esso specificate vengono applicate all'indicatore dopo la sua creazione, sovrascrivendo le opzioni predefinite, se esistenti.
  • Se viene specificata una funzione, viene richiamata una volta quando viene creato l'indicatore, prima che venga aggiunto alla visualizzazione mappa. In questa chiamata, il parametro isNew nell'oggetto parametri della funzione è impostato su true. Inoltre, questa funzione viene invocata quando il fornitore di servizi di geolocalizzazione riceve dati da Fleet Engine, indipendentemente dal fatto che i dati corrispondenti a questo indicatore siano cambiati.

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

Interfaccia FleetEngineTripLocationProviderUpdateEvent

google.maps.journeySharing.FleetEngineTripLocationProviderUpdateEvent interfaccia

L'oggetto evento passato al gestore dell'evento quando viene attivato l'evento FleetEngineTripLocationProvider.update.

trip optional
Tipo:  Trip optional
La struttura del viaggio restituita dall'aggiornamento. Non modificabili.