Fleet Tracking - On Demand Rides & Delivery

Classe FleetEngineVehicleLocationProvider

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

Fornitore di posizione del veicolo.

const {FleetEngineVehicleLocationProvider} = await google.maps.importLibrary("journeySharing");
FleetEngineVehicleLocationProvider
FleetEngineVehicleLocationProvider(options)
Parametri:
Crea un nuovo provider di località per un veicolo 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 FleetEngineVehicleLocationProviderOptions.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 FleetEngineVehicleLocationProviderOptions.remainingPolylineCustomization per eseguire il rendering di una polilinea che tiene conto del traffico per la polilinea rimanente.
staleLocationThresholdMillis
Tipo: number
Questo campo è di sola lettura. Soglia per la posizione del veicolo non aggiornata. Se l'ultima posizione aggiornata del veicolo è precedente a questa soglia, il veicolo non verrà visualizzato.
vehicleId
Tipo: string
ID del veicolo osservato da questo provider di geolocalizzazione. Imposta questo campo per monitorare un veicolo.
Ereditato: isPolling, pollingIntervalMillis
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 FleetEngineVehicleLocationProviderOptions

Interfaccia google.maps.journeySharing.FleetEngineVehicleLocationProviderOptions

Opzioni per il fornitore della posizione del veicolo.
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 VehiclePolylineCustomizationFunctionParams per un elenco dei parametri forniti e dei relativi utilizzi.
destinationMarkerCustomization
facoltativo
Personalizzazione applicata all'indicatore della destinazione del percorso 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 VehicleWaypointMarkerCustomizationFunctionParams per un elenco dei parametri forniti e dei relativi utilizzi.
intermediateDestinationMarkerCustomization
facoltativo
Personalizzazione applicata agli indicatori delle destinazioni intermedie del percorso 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 VehicleWaypointMarkerCustomizationFunctionParams per un elenco dei parametri forniti e dei relativi utilizzi.
originMarkerCustomization
facoltativo
Personalizzazione applicata all'indicatore di origine del percorso 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 VehicleWaypointMarkerCustomizationFunctionParams 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 VehiclePolylineCustomizationFunctionParams per un elenco dei parametri forniti e dei relativi utilizzi.
staleLocationThresholdMillis
facoltativo
Tipo: number optional
Soglia per la posizione del veicolo non aggiornata. Se l'ultima posizione aggiornata del veicolo è precedente a questa soglia, il veicolo non verrà visualizzato. Il valore predefinito è 24 ore in millisecondi. Se la soglia è inferiore a 0 o Infinity, verrà ignorata e la posizione del veicolo non verrà considerata obsoleta.
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 VehiclePolylineCustomizationFunctionParams per un elenco dei parametri forniti e dei relativi utilizzi.
vehicleId
facoltativo
Tipo: string optional
L'ID veicolo da monitorare immediatamente dopo la creazione dell'istanza del provider di geolocalizzazione. Se non viene specificato, il provider di geolocalizzazione non inizia a monitorare alcun veicolo; utilizza FleetEngineVehicleLocationProvider.vehicleId per impostare l'ID e iniziare il monitoraggio.
vehicleMarkerCustomization
facoltativo
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 VehicleMarkerCustomizationFunctionParams per un elenco dei parametri forniti e dei relativi utilizzi.

Interfaccia FleetEngineVehicleLocationProviderUpdateEvent

Interfaccia google.maps.journeySharing.FleetEngineVehicleLocationProviderUpdateEvent

L'oggetto evento passato al gestore di eventi quando viene attivato l'evento FleetEngineVehicleLocationProvider.update.
trips
facoltativo
Tipo: Array<Trip> optional
L'elenco delle corse completate da questo veicolo. Non modificabile.
vehicle
facoltativo
Tipo: Vehicle optional
La struttura dei dati del veicolo restituita dall'aggiornamento. Non modificabile.

Classe FleetEngineFleetLocationProvider

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

Provider di posizione del parco veicoli.

const {FleetEngineFleetLocationProvider} = await google.maps.importLibrary("journeySharing");
FleetEngineFleetLocationProvider
FleetEngineFleetLocationProvider(options)
Parametri:
Crea un nuovo provider di posizione per i veicoli monitorati da Fleet Engine.
locationRestriction
I limiti entro i quali monitorare i veicoli. Se non vengono impostati limiti, non verrà monitorato alcun veicolo. Per monitorare tutti i veicoli indipendentemente dalla località, imposta limiti equivalenti all'intera Terra.
staleLocationThresholdMillis
Tipo: number
Questo campo è di sola lettura. Soglia per la posizione del veicolo non aggiornata. Se l'ultima posizione aggiornata del veicolo è precedente a questa soglia, il veicolo non verrà visualizzato.
vehicleFilter
Tipo: string optional
Il filtro applicato durante il recupero dei veicoli.
Ereditato: isPolling, pollingIntervalMillis
Ereditato: addListener
update
function(event)
Argomenti:
Evento che viene attivato al termine di una richiesta di aggiornamento dei dati di Fleet Engine.
Ereditato: ispollingchange

Interfaccia FleetEngineFleetLocationProviderOptions

Interfaccia google.maps.journeySharing.FleetEngineFleetLocationProviderOptions

Opzioni per il provider di posizione del parco risorse.
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.
locationRestriction
facoltativo
I limiti di latitudine/longitudine entro i quali monitorare i veicoli immediatamente dopo la creazione dell'istanza del provider di geolocalizzazione. Se non viene impostato, il provider di geolocalizzazione non inizia a monitorare i veicoli; utilizza FleetEngineFleetLocationProvider.locationRestriction per impostare i limiti e iniziare il monitoraggio. Per monitorare tutti i veicoli indipendentemente dalla località, imposta limiti equivalenti all'intera Terra.
staleLocationThresholdMillis
facoltativo
Tipo: number optional
Soglia per la posizione del veicolo non aggiornata. Se l'ultima posizione aggiornata del veicolo è precedente a questa soglia, il veicolo non verrà visualizzato. Il valore predefinito è 24 ore in millisecondi. Se la soglia è inferiore a zero o è impostata su Infinity, verrà ignorata e la posizione del veicolo non verrà considerata obsoleta.
vehicleFilter
facoltativo
Tipo: string optional
Una query di filtro da applicare durante il recupero dei veicoli. Questo filtro viene passato direttamente a Fleet Engine.

Consulta ListVehiclesRequest.filter per i formati supportati.

Tieni presente che i filtri validi per gli attributi devono avere il prefisso "attributes". Ad esempio: attributes.x = "y" o attributes."x y" = "z".
vehicleMarkerCustomization
facoltativo
Tipo: function(VehicleMarkerCustomizationFunctionParams): void optional
Personalizzazione applicata a un 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 VehicleMarkerCustomizationFunctionParams per un elenco dei parametri forniti e dei relativi utilizzi.

Interfaccia FleetEngineFleetLocationProviderUpdateEvent

Interfaccia google.maps.journeySharing.FleetEngineFleetLocationProviderUpdateEvent

L'oggetto evento passato al gestore di eventi quando viene attivato l'evento FleetEngineFleetLocationProvider.update.
vehicles
facoltativo
Tipo: Array<Vehicle> optional
L'elenco dei veicoli restituiti dalla query. Non modificabile.