Trip and Order Progress

Classe FleetEngineTripLocationProvider

google.maps.journeySharing.FleetEngineTripLocationProvider class
extends PollingLocationProvider
library "journeySharing"

Fornitore di località del percorso.

const {FleetEngineTripLocationProvider} = await google.maps.importLibrary("journeySharing");
FleetEngineTripLocationProvider
FleetEngineTripLocationProvider(options)
Parametri:
Crea un nuovo provider di posizione per un percorso di 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 lettura della velocità. Specifica questa funzione come FleetEngineTripLocationProviderOptions.activePolylineCustomization per eseguire il rendering di una polilinea che tiene conto del 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 lettura della velocità. Specifica questa funzione come FleetEngineTripLocationProviderOptions.remainingPolylineCustomization per eseguire il rendering di una polilinea che tiene conto del traffico per la polilinea rimanente.
tripId
Tipo: string
L'ID della corsa osservata da questo provider 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 che viene attivato quando il provider di posizione rileva un errore.
update
function(event)
Argomenti:
Evento che viene attivato al termine di una richiesta di aggiornamento dei dati di Fleet Engine.
Ereditato: ispollingchange

Interfaccia FleetEngineTripLocationProviderOptions

Interfaccia google.maps.journeySharing.FleetEngineTripLocationProviderOptions

Opzioni per il provider di località del percorso.

authTokenFetcher
Fornisce i token web JSON per l'autenticazione del client in Fleet Engine.
projectId
Tipo: string
L'ID progetto del consumer dalla console Google Cloud.
activePolylineCustomization
facoltativo
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 al suo interno vengono applicate alla polilinea dopo la sua creazione, sovrascrivendo le opzioni predefinite, se esistenti.
  • Se viene specificata una funzione, questa viene richiamata una volta al momento della creazione della polilinea. (In questa chiamata, il parametro isNew nell'oggetto dei parametri della funzione è impostato su true). Inoltre, questa funzione viene richiamata quando le coordinate della polilinea cambiano o quando il provider di località 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
facoltativo
Tipo: (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Personalizzazione applicata all'indicatore di destinazione.

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

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

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

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

Se imposti questo valore su 0, gli aggiornamenti della posizione ricorrenti vengono disattivati. Un nuovo aggiornamento della posizione viene recuperato se uno dei parametri osservati dal provider di geolocalizzazione cambia.

L'intervallo di polling predefinito è di 5000 millisecondi, ovvero l'intervallo minimo. Se imposti l'intervallo di polling su un valore inferiore diverso da zero, viene utilizzato 5000.
remainingPolylineCustomization
facoltativo
Personalizzazione applicata alla polilinea rimanente. Una polilinea rimanente corrisponde a una parte del percorso che il veicolo non ha ancora iniziato ad attraversare.

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 al suo interno vengono applicate alla polilinea dopo la sua creazione, sovrascrivendo le opzioni predefinite, se esistenti.
  • Se viene specificata una funzione, questa viene richiamata una volta al momento della creazione della polilinea. (In questa chiamata, il parametro isNew nell'oggetto dei parametri della funzione è impostato su true). Inoltre, questa funzione viene richiamata quando le coordinate della polilinea cambiano o quando il provider di località 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
facoltativo
Personalizzazione applicata alla polilinea presa. 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 al suo interno vengono applicate alla polilinea dopo la sua creazione, sovrascrivendo le opzioni predefinite, se esistenti.
  • Se viene specificata una funzione, questa viene richiamata una volta al momento della creazione della polilinea. (In questa chiamata, il parametro isNew nell'oggetto dei parametri della funzione è impostato su true). Inoltre, questa funzione viene richiamata quando le coordinate della polilinea cambiano o quando il provider di località 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
facoltativo
Tipo: string optional
L'ID percorso da monitorare immediatamente dopo la creazione dell'istanza del provider di geolocalizzazione. Se non viene specificato, il provider di localizzazione non inizia a monitorare alcun percorso; utilizza FleetEngineTripLocationProvider.tripId per impostare l'ID e iniziare il monitoraggio.
vehicleMarkerCustomization
facoltativo
Tipo: (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Personalizzazione applicata all'indicatore del veicolo.

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

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

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

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

Interfaccia FleetEngineTripLocationProviderUpdateEvent

Interfaccia google.maps.journeySharing.FleetEngineTripLocationProviderUpdateEvent

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

trip
facoltativo
Tipo: Trip optional
La struttura del percorso restituita dall'aggiornamento. Non modificabile.