Shipment Tracking

Classe FleetEngineShipmentLocationProvider

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

Fornitore della località di spedizione.

const {FleetEngineShipmentLocationProvider} = await google.maps.importLibrary("journeySharing");
FleetEngineShipmentLocationProvider
FleetEngineShipmentLocationProvider(options)
Parametri:
Crea un nuovo provider di posizione per il monitoraggio delle spedizioni di Fleet Engine.
trackingId
Tipo: string
L'ID monitoraggio dell'attività 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)
Evento che viene attivato al termine di una richiesta di aggiornamento dei dati di Fleet Engine.
Ereditato: ispollingchange

Interfaccia FleetEngineShipmentLocationProviderOptions

Interfaccia google.maps.journeySharing.FleetEngineShipmentLocationProviderOptions

Opzioni per il fornitore della località di spedizione.

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 ShipmentPolylineCustomizationFunctionParams per un elenco dei parametri forniti e dei relativi utilizzi.
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 ShipmentMarkerCustomizationFunctionParams per un elenco dei parametri forniti e dei relativi utilizzi.
destinationMarkerCustomization
facoltativo
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 ShipmentMarkerCustomizationFunctionParams 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, Infinity o un valore negativo, gli aggiornamenti automatici della posizione vengono disattivati. Un nuovo aggiornamento della posizione viene recuperato una volta se il parametro dell'ID monitoraggio (ad esempio l'ID monitoraggio della spedizione del fornitore della posizione della spedizione) o un'opzione di filtro (ad esempio i limiti dell'area visibile o i filtri degli attributi per i fornitori della posizione della flotta) cambia.

L'intervallo di polling predefinito e minimo è di 5000 millisecondi. Se imposti l'intervallo di polling su un valore positivo inferiore, viene memorizzato e 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 ShipmentPolylineCustomizationFunctionParams 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 ShipmentPolylineCustomizationFunctionParams per un elenco dei parametri forniti e dei relativi utilizzi.
trackingId
facoltativo
Tipo: string optional
L'ID monitoraggio dell'attività da monitorare immediatamente dopo la creazione dell'istanza del provider di geolocalizzazione. Se non viene specificato, il provider di geolocalizzazione non inizia a monitorare alcuna attività; utilizza FleetEngineShipmentLocationProvider.trackingId per impostare l'ID monitoraggio e iniziare il monitoraggio.

Interfaccia FleetEngineShipmentLocationProviderUpdateEvent

Interfaccia google.maps.journeySharing.FleetEngineShipmentLocationProviderUpdateEvent

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

taskTrackingInfo
facoltativo
Tipo: TaskTrackingInfo optional
La struttura delle informazioni del tracker delle attività restituita dall'aggiornamento. Non modificabile.