Riferimento rapido per il servizio Fleet Engine

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

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: 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_FOUND durante 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_EXCEEDED quando una richiesta richiede più tempo del timeout predefinito della libreria client. Correzione: modifica le impostazioni di ripetizione RPC (ad esempio, setTotalTimeout su VehicleServiceSettings nel 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 ReportBillableTrip sia 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 chiamate ReportBillableTrip. 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: UpdateVehicle in VehicleService. Sintomo: ritirato il 1° febbraio 2024; dismesso a maggio 2024.
  • Metodo SearchFuzzedVehicles: ritirato dal 1° maggio 2024. Sostituzione: SearchVehicles in VehicleService. Sintomo: ritirato il 1° febbraio 2024; dismesso a maggio 2024.
  • Metodo SearchTasks: ritirato dal 1° maggio 2024. Sostituzione: GetTaskTrackingInfo in DeliveryService. Sintomo: ritirato il 1° febbraio 2024; dismesso a maggio 2024.
  • ReportBillableTrip dopo 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 Billing reportBillableEvent. 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.