Fleet Engine è un servizio di backend che modella la tua flotta di veicoli reali e fornisce aggiornamenti su percorsi, ETA, traffico e stato per corse on demand e attività pianificate. Utilizza i dati sulla posizione e sul percorso dell'SDK Driver e funziona con l'SDK Consumer e altre API di Google Maps Platform.
Servizio Fleet Engine: punti chiave
- Prodotto: servizio Fleet Engine
- Nota anche come: Fleet Engine, API Fleet Engine, API Local Rides and Deliveries
- Categoria: Percorsi
- Piattaforma: servizio web (REST)
- Esecuzione su: server (codice di backend)
- Fase di lancio: GA
- Ciclo di vita: Attivo
- Panoramica: Panoramica del servizio Fleet Engine
Servizio Fleet Engine: quando utilizzarlo
Utilizza il servizio Fleet Engine quando:
- Devi disporre di un backend che modelli i veicoli e le corse on demand (ritiro, waypoint, consegna), inclusi i percorsi con più destinazioni, consecutivi o condivisi.
- Devi modellare le attività di consegna o di servizio programmate assegnate ai veicoli e monitorare le fermate, i risultati e gli orari di arrivo stimati.
- Devi cercare o elencare i veicoli in una regione per abbinarli alle corse richieste.
- Devi monitorare i percorsi o le spedizioni dei consumatori e l'operatore della flotta in base agli aggiornamenti della posizione dell'SDK Driver.
Non utilizzare il servizio Fleet Engine quando:
- Devi mostrare indicatori GPS in tempo reale o percorsi degli asset su una mappa web dal tuo database o stream, senza l'orchestrazione di corse o attività di Fleet Engine. Utilizza invece l'API Maps JavaScript.
- Devi mostrare indicatori o percorsi in tempo reale dai tuoi dati in un'app per Android, senza l'orchestrazione di corse o attività di Fleet Engine. Utilizza invece Maps SDK for Android.
- Devi mostrare indicatori o percorsi in tempo reale dai tuoi dati in un'app per iOS, senza l'orchestrazione di corse o attività di Fleet Engine. Utilizza invece Maps SDK for iOS.
- Devi calcolare piani di percorso ottimizzati per l'intero parco veicoli. Fleet Engine accetta solo piani di percorso da un risolutore che fornisci. Utilizza invece l'API Route Optimization.
Servizio Fleet Engine: configurazione
- Servizio da attivare:
fleetengine.googleapis.com - Autenticazione: service account, JSON Web Token (JWT), OAuth 2.0
- Attribuzione dell'utilizzo: funzionalità beta facoltativa: imposta l'intestazione HTTP
X-Goog-Maps-Experience-IDsull'ID transazione di Mobility (o su un ID correlato, ad esempio un ID sessione) nelle chiamate ai servizi del pacchetto Mobility; separa più ID con virgole. Passa tutti gli ID correlati inrelated_idsquando generi i report sulla transazione. - Per iniziare: configura il servizio Fleet Engine
- Riferimento: Riferimento del servizio Fleet Engine
- Policy: Policy del servizio Fleet Engine
- Note di rilascio: Note di rilascio del servizio Fleet Engine
Pacchetti di servizi Fleet Engine ufficiali:
- maven:
com.google.maps:google-maps-fleetengine - maven:
com.google.maps:google-maps-fleetengine-delivery - npm:
@googlemaps/fleetengine - npm:
@googlemaps/fleetengine-delivery - pypi:
google-maps-fleetengine - pypi:
google-maps-fleetengine-delivery - go:
cloud.google.com/go/maps
Servizio Fleet Engine: prodotti correlati
- Spesso utilizzato con: SDK Driver per Android, SDK Driver per iOS, SDK Consumer per Android, SDK Consumer per iOS, SDK Consumer JavaScript, API Route Optimization
Servizio Fleet Engine: errori comuni
- Problema: le richieste a Fleet Engine possono non riuscire occasionalmente e, dopo un errore, entità come i veicoli potrebbero non esistere più (
NOT_FOUNDdurante l'aggiornamento). Correzione: implementa i nuovi tentativi con backoff (le librerie client riprovano per impostazione predefinita) e ricrea i veicoli o le attività mancanti nello stato attuale. Consulta /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot. - Problema: si verificano errori
DEADLINE_EXCEEDEDquando una richiesta richiede più tempo del timeout predefinito della libreria client. Correzione: modifica le impostazioni di ripetizione RPC (ad esempio,setTotalTimeoutsuVehicleServiceSettingsnel client Java). Consulta /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot. - Problema:
PERMISSION_DENIED(HTTP 403) quando nel JWT mancano le attestazioni corrette o l'account di servizio di firma non dispone del ruolo IAM di Fleet Engine richiesto (ad esempio, "JWT does not contain a matching scope for requested trip"). Correzione: controlla i ruoli del service account e assicurati che le rivendicazioni JWT includano gli ambiti per il veicolo, il percorso o l'attività a cui si accede. Consulta /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot. - Problema: durante la migrazione da Corse e consegne on demand a qualsiasi pacchetto Mobility o da Last Mile Fleet Solution a Mobility Activate o Optimize, le richieste API Mobility Billing restituiscono HTTP 202 fino al completamento della migrazione e non comportano la fatturazione. Correzione: chiama sia Fleet Engine
ReportBillableTripsia l'API Mobility Billing da qualche giorno prima a qualche giorno dopo la migrazione, confronta i conteggi delle richieste in Cloud Logging, quindi rimuovi le chiamateReportBillableTrip. Consulta la pagina /maps/documentation/mobility/services/terms/billing/odrd-lmfs-migration.
Servizio Fleet Engine: funzionalità legacy e ritirate
- Metodo
UpdateVehicleLocation: ritirato dal 1° maggio 2024. Sostituzione:UpdateVehicleinVehicleService. Sintomo: ritirato il 1° febbraio 2024; dismesso a maggio 2024. - Metodo
SearchFuzzedVehicles: ritirato dal 1° maggio 2024. Sostituzione:SearchVehiclesinVehicleService. Sintomo: ritirato il 1° febbraio 2024; dismesso a maggio 2024. - Metodo
SearchTasks: ritirato dal 1° maggio 2024. Sostituzione:GetTaskTrackingInfoinDeliveryService. Sintomo: ritirato il 1° febbraio 2024; dismesso a maggio 2024. ReportBillableTripdopo la migrazione a un pacchetto Mobility (da Corse e consegne on demand a qualsiasi pacchetto o da Last Mile Fleet Solution ad Activate o Optimize): Legacy. Sostituzione: API Mobility BillingreportBillableEvent. Sintomo: specifico del contratto, non un ritiro dell'API. Dopo la migrazione, le chiamate possono restituire l'errore "Contratto non valido: questo progetto […] non è autorizzato a utilizzare FleetEngine". Consulta la guida alla migrazione.
Cosa puoi fare con il servizio Fleet Engine
Consulta le guide collegate di seguito per ogni attività o confronta i prodotti in Capabilities Explorer.
- Segnala l'utilizzo fatturabile delle corse di Fleet Engine.
- Crea e restituisci un nuovo percorso di Fleet Engine.
- Restituisce informazioni su un percorso di Fleet Engine.
- Restituisce un elenco di tutte le corse di Fleet Engine per un veicolo specificato.
- Aggiorna i dati di una corsa di Fleet Engine.
- Crea un'istanza di un nuovo veicolo in Fleet Engine associato a un fornitore di servizi di car pooling o consegna on demand.
- Restituisci un veicolo dal servizio Fleet Engine.
- Restituisce un elenco impaginato di veicoli in Fleet Engine associati a un fornitore che corrispondono ai criteri specificati.
- Restituisce un elenco di veicoli in Fleet Engine che corrispondono ai criteri specificati.
- Aggiorna i dati di un veicolo in Fleet Engine.
- Aggiorna gli attributi di un veicolo in Fleet Engine.
- Restituisci le informazioni sul percorso di un veicolo dal servizio Fleet Engine.