Fleet Tracking - Last Mile Fleet

Classe FleetEngineDeliveryVehicleLocationProvider

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

Provider di posizione dei veicoli per le consegne.

const {FleetEngineDeliveryVehicleLocationProvider} = await google.maps.importLibrary("journeySharing");
FleetEngineDeliveryVehicleLocationProvider
FleetEngineDeliveryVehicleLocationProvider(options)
Parametri:
Crea un nuovo provider di località per un veicolo di consegna di Fleet Engine.
deliveryVehicleId
Tipo: string
ID del veicolo osservato da questo provider di geolocalizzazione. Imposta questo campo per monitorare un veicolo.
shouldShowOutcomeLocations
Tipo: boolean optional
Facoltativamente, consenti agli utenti di visualizzare la posizione del risultato dell'attività.
shouldShowTasks
Tipo: boolean optional
(Facoltativo) Consenti agli utenti di visualizzare le attività recuperate.
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.
taskFilterOptions
Restituisce le opzioni di filtro da applicare durante il recupero delle attività.
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 FleetEngineDeliveryVehicleLocationProviderOptions

Interfaccia google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProviderOptions

Opzioni per il provider di posizione del veicolo per le consegne.
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 DeliveryVehiclePolylineCustomizationFunctionParams per un elenco dei parametri forniti e dei relativi utilizzi.
deliveryVehicleId
facoltativo
Tipo: string optional
L'ID del veicolo per le consegne da monitorare immediatamente dopo l'inizializzazione del provider di geolocalizzazione. Se non viene specificato, il provider di geolocalizzazione non inizia a monitorare alcun veicolo; utilizza FleetEngineDeliveryVehicleLocationProvider.deliveryVehicleId per impostare l'ID e iniziare il monitoraggio.
deliveryVehicleMarkerCustomization
facoltativo
Personalizzazione applicata all'indicatore del veicolo per le consegne.

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 DeliveryVehicleMarkerCustomizationFunctionParams per un elenco dei parametri forniti e dei relativi utilizzi.
plannedStopMarkerCustomization
facoltativo
Personalizzazione applicata a un indicatore di fermata pianificata.

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 PlannedStopMarkerCustomizationFunctionParams 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 DeliveryVehiclePolylineCustomizationFunctionParams per un elenco dei parametri forniti e dei relativi utilizzi.
shouldShowOutcomeLocations
facoltativo
Tipo: boolean optional
Valore booleano per mostrare o nascondere le posizioni dei risultati per le attività recuperate.
shouldShowTasks
facoltativo
Tipo: boolean optional
Valore booleano per mostrare o nascondere le attività. Se questo valore è impostato su false, l'endpoint ListTasks non verrà chiamato per recuperare le attività. Verranno visualizzate solo le fermate del veicolo imminenti.
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 DeliveryVehiclePolylineCustomizationFunctionParams per un elenco dei parametri forniti e dei relativi utilizzi.
taskFilterOptions
facoltativo
Opzioni di filtro da applicare durante il recupero delle attività. Le opzioni possono includere veicolo, ora e stato dell'attività specifici.
taskMarkerCustomization
facoltativo
Tipo: (function(TaskMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Personalizzazione applicata a un indicatore di attività. Un indicatore di attività viene visualizzato nella posizione pianificata di ogni attività assegnata al veicolo di consegna.

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 TaskMarkerCustomizationFunctionParams per un elenco dei parametri forniti e dei relativi utilizzi.
taskOutcomeMarkerCustomization
facoltativo
Tipo: function(TaskMarkerCustomizationFunctionParams): void optional
Personalizzazione applicata a un indicatore di risultato dell'attività. Un indicatore del risultato dell'attività viene visualizzato nella posizione del risultato effettivo di ogni attività assegnata al veicolo di consegna.

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 TaskMarkerCustomizationFunctionParams per un elenco dei parametri forniti e dei relativi utilizzi.

Interfaccia FleetEngineTaskFilterOptions

Interfaccia google.maps.journeySharing.FleetEngineTaskFilterOptions

Opzioni di filtro per le attività nel provider di posizione del veicolo di consegna.
completionTimeFrom
facoltativo
Tipo: Date optional
Limite inferiore esclusivo per l'ora di completamento dell'attività. Utilizzato per filtrare le attività completate dopo l'ora specificata.
completionTimeTo
facoltativo
Tipo: Date optional
Limite superiore esclusivo per l'ora di completamento dell'attività. Utilizzato per filtrare le attività completate prima dell'ora specificata.
state
facoltativo
Tipo: string optional
Lo stato dell'attività. I valori validi sono OPEN o CLOSED.

Interfaccia FleetEngineDeliveryVehicleLocationProviderUpdateEvent

Interfaccia google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProviderUpdateEvent

L'oggetto evento passato al gestore di eventi quando viene attivato l'evento FleetEngineDeliveryVehicleLocationProvider.update.
completedVehicleJourneySegments
facoltativo
I segmenti del percorso completati da questo veicolo. Non modificabile.
deliveryVehicle
facoltativo
Tipo: DeliveryVehicle optional
La struttura dei dati del veicolo di consegna restituita dall'aggiornamento. Non modificabile.
tasks
facoltativo
Tipo: Array<Task> optional
L'elenco delle attività gestite da questo veicolo di consegna. Non modificabile.

Classe FleetEngineDeliveryFleetLocationProvider

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

Provider di posizione per la flotta di consegna.

const {FleetEngineDeliveryFleetLocationProvider} = await google.maps.importLibrary("journeySharing");
FleetEngineDeliveryFleetLocationProvider
FleetEngineDeliveryFleetLocationProvider(options)
Parametri:
Crea un nuovo provider di posizione per i veicoli monitorati da Fleet Engine.
deliveryVehicleFilter
Tipo: string optional
Il filtro applicato durante il recupero dei veicoli per le consegne.
locationRestriction
I limiti entro i quali monitorare i veicoli per le consegne. Se non vengono impostati limiti, non verrà monitorato alcun veicolo per le consegne. Per monitorare tutti i veicoli di consegna 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.
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 FleetEngineDeliveryFleetLocationProviderOptions

Interfaccia google.maps.journeySharing.FleetEngineDeliveryFleetLocationProviderOptions

Opzioni per il provider di località della flotta di consegna.
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.
deliveryVehicleFilter
facoltativo
Tipo: string optional
Una query di filtro da applicare durante il recupero dei veicoli di consegna. Questo filtro viene passato direttamente a Fleet Engine.

Consulta ListDeliveryVehiclesRequest.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".
deliveryVehicleMarkerCustomization
facoltativo
Personalizzazione applicata a un indicatore di un veicolo per le consegne.

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 DeliveryVehicleMarkerCustomizationFunctionParams per un elenco dei parametri forniti e dei relativi utilizzi.
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 FleetEngineDeliveryFleetLocationProvider.locationRestriction per impostare i limiti e iniziare il monitoraggio. Per monitorare tutti i veicoli di consegna 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.

Interfaccia FleetEngineDeliveryFleetLocationProviderUpdateEvent

Interfaccia google.maps.journeySharing.FleetEngineDeliveryFleetLocationProviderUpdateEvent

L'oggetto evento passato al gestore di eventi quando viene attivato l'evento FleetEngineDeliveryFleetLocationProvider.update.
deliveryVehicles
facoltativo
Tipo: Array<DeliveryVehicle> optional
L'elenco dei veicoli per le consegne restituito dalla query. Non modificabile.