Che cos'è il servizio Fleet Engine?

Fleet Engine è un servizio di backend che si integra con il sistema che utilizzi per gestire i servizi di trasporto per i tuoi clienti. Interopera con una varietà di API e SDK per migliorare la mappatura, il routing e la gestione della posizione.

Fleet Engine fornisce aggiornamenti su percorsi e stato per le entità veicolo modellate sulla tua flotta di veicoli reali. Man mano che il tuo sistema invia aggiornamenti sull'avanzamento del veicolo a Fleet Engine, quest'ultimo utilizza le informazioni sulla posizione e sul percorso del veicolo in tempo reale fornite dall'SDK Driver per fornire report accurati sui percorsi del veicolo: ETA, informazioni sul traffico e disponibilità del veicolo.

Fleet Engine

Il servizio Fleet Engine funziona con entrambe le seguenti offerte di servizi di mobilità:

  • Corse on demand: in questa offerta, Fleet Engine modella il ciclo di vita di un percorso, dall'origine alle fermate fino alla destinazione. Nel ciclo di vita di un percorso, un veicolo passa attraverso i luoghi di partenza, i waypoint intermedi e i luoghi di arrivo per completare un percorso prenotato da un consumatore. Per informazioni dettagliate sulle corse on-demand, consulta la documentazione relativa alle corse on-demand.
  • Attività pianificate: in questa offerta, Fleet Engine modella il ciclo di vita di un'attività di consegna o di servizio, in cui ogni fermata lungo un percorso richiede al conducente di completare una o più attività pianificate. Le attività possono includere la consegna di un pacco o il completamento di una chiamata di servizio. Per informazioni dettagliate sulle attività pianificate, consulta la documentazione relativa alle attività pianificate.

Cosa puoi fare con Fleet Engine

Utilizzando i componenti di Fleet Engine, puoi:

  • Attiva il monitoraggio dei percorsi dei consumatori: per i percorsi on demand, puoi utilizzare le funzionalità di esperienza del consumatore di Fleet Engine e integrare l'SDK Consumer nelle tue app mobile o web. In questo modo, i tuoi clienti possono utilizzare la stessa app per effettuare una richiesta di corsa e monitorare il tragitto.
  • Fornisci ai clienti informazioni sui pacchi in tempo reale: per le attività pianificate, puoi utilizzare le funzionalità di esperienza del consumatore di Fleet Engine e integrare l'SDK consumer JavaScript nella tua app web. In questo modo, i consumatori possono ricevere aggiornamenti quasi in tempo reale sullo stato dei loro pacchi. L'SDK fornisce filtri integrati e privacy dei dati in modo che i consumatori vedano solo le informazioni pertinenti al loro ordine.
  • Progetta soluzioni per gli operatori del parco risorse: per le attività pianificate, utilizza la libreria di monitoraggio del parco risorse JavaScript in modo che gli operatori del parco risorse possano coordinare e gestire meglio le assegnazioni dei veicoli durante il giorno.
  • Migliora l'esperienza dei tuoi conducenti: l'SDK Driver è un toolkit per app mobile e un componente fondamentale di Fleet Engine. Utilizza la funzionalità dei veicoli. Con questo SDK, la tua app di guida può gestire le assegnazioni di lavoro e abilitare le funzionalità di navigazione e routing per i conducenti. In sostanza, l'SDK utilizza un listener di eventi per inviare aggiornamenti della posizione a Fleet Engine quando il conducente inizia a guidare. Invia anche indicatori a Fleet Engine sullo stato del veicolo. Con questo SDK, il conducente può utilizzare un'unica app per gestire le assegnazioni e navigare come farebbe con la versione consumer di Google Maps, ma senza dover passare a un'altra app.

Più nello specifico, con queste soluzioni puoi fornire quanto segue:

Corse on demand

  • La posizione in tempo reale del veicolo del conducente, agganciata alla strada.
  • Il percorso effettivo del conducente con informazioni sul traffico in tempo reale.
  • L'orario di arrivo stimato per le località di partenza e di arrivo.
  • Monitoraggio per corse con una o più destinazioni e corse consecutive.
  • Corse in carpooling per più clienti lungo lo stesso percorso.
  • Elenco di tutti i veicoli all'interno di una regione specifica per trovare le corrispondenze migliori per le corse richieste.

Attività pianificate

  • Aggiornamenti della posizione in tempo reale visualizzati sulla mappa.
  • ETA regolati automaticamente che riflettono le circostanze mutevoli, come il traffico.
  • Attività completate e fermate in attesa per fornire informazioni su possibili problemi.
  • Il numero di fermate e la distanza, in modo che i clienti abbiano una maggiore fiducia.

Come funziona Fleet Engine

Questa sezione fornisce una panoramica generale delle operazioni dei sistemi Fleet Engine per ogni offerta di mobilità.

Corse on demand

Il seguente diagramma mostra due parti chiave delle corse on demand: l'inizio della giornata, quando i conducenti attivano la Condivisione della posizione con Fleet Engine, e una visualizzazione semplificata della gestione delle corse utilizzando i componenti di Fleet Engine. Per una visualizzazione dettagliata della procedura di un percorso, consulta Che cos'è un percorso? nella documentazione relativa alle corse on demand.

Attività pianificate

Il seguente diagramma mostra una matrice di una tipica giornata lavorativa di spedizione per un singolo conducente, insieme al modo in cui il suo lavoro viene gestito nel sistema Fleet Engine utilizzando la libreria di Fleet Tracking.

Nota: il tuo sistema può utilizzare sia il monitoraggio delle spedizioni sia il monitoraggio della flotta. Con il monitoraggio delle spedizioni, Fleet Engine filtra le informazioni sulla spedizione e sul conducente in modo che un cliente veda solo le informazioni pertinenti alla sua spedizione.

Architettura di Fleet Engine

Questa sezione fornisce un'architettura di sistema per le diverse offerte di Fleet Engine. Entrambi i servizi utilizzano:

  • Un veicolo: i percorsi on demand e le attività pianificate si basano su un veicolo come mezzo per modellare i veicoli reali della tua attività utilizzati per svolgere le operazioni. In Fleet Engine, un'entità veicolo riceve i dati sulla posizione forniti dal veicolo reale associato tramite l'app per i conducenti integrata con l'SDK Driver. I veicoli di Fleet Engine sono in gran parte entità parallele tra i due servizi, con alcune differenze. Leggi Introduzione ai veicoli per comprendere i veicoli in Fleet Engine.
  • SDK Driver: l'SDK Driver è un componente fondamentale sia per le attività on demand che per quelle pianificate. L'SDK Driver si integra con l'app per i conducenti e fornisce a Fleet Engine un flusso di aggiornamenti della posizione insieme alle informazioni sul percorso su cui Fleet Engine si basa per segnalare lo stato in tempo reale del percorso, insieme ad altre informazioni come l'orario di arrivo stimato e i dati sul traffico.
  • SDK Consumer: un vantaggio fondamentale sia per le attività on demand che per quelle pianificate è l'SDK Consumer, utilizzato per segnalare al consumatore lo stato della sua corsa, della consegna di cibo o della consegna di pacchi pianificata.

Corse on demand

Per una spiegazione di veicoli, corse e SDK, consulta la documentazione relativa alle corse on demand:

  1. Introduzione ai veicoli
  2. Corse on demand
  3. SDK Driver per corse on demand
  4. SDK consumer per corse on demand

Attività pianificate

Per una spiegazione dei veicoli per le consegne, delle attività e degli SDK, consulta la documentazione relativa alle attività pianificate:

  1. Introduzione ai veicoli
  2. Attività pianificate
  3. SDK Driver per le attività pianificate
  4. SDK consumer per le attività pianificate

Risorse

Corse on demand

Veicolo
Servizi REST: v1.providers.vehicles
gRPC: maps.fleetengine.v1.VehicleService
Nome della risorsa providers/{provider}/vehicles/{vehicle}
Percorso
Servizi REST: v1.providers.trips
gRPC: maps.fleetengine.v1.TripService
Nome della risorsa providers/{provider}/trips/{trip}

Attività pianificate

Veicolo per le consegne
Risorse REST: providers.deliveryVehicles
gRPC: maps.delivery.v1
Nome della risorsa providers/{provider}/deliveryVehicles/{vehicle}
Attività
Servizi REST: providers.tasks
gRPC: maps.fleetengine.delivery.v1.Task
Nome della risorsa providers/{provider}/tasks/{task}

Denominazione delle risorse in Fleet Engine

In Fleet Engine, come in tutti i servizi basati su Google Cloud, le risorse hanno identificatori univoci chiamati names, forniti in formato stringa. Parte del nome della risorsa è un ID risorsa, che fornisci quando invii una richiesta di creazione. Tuttavia, le risorse di Fleet Engine non hanno un campo ID, ma un campo nome di sola uscita, che include l'ID risorsa.

Fleet Engine utilizza nomi delle risorse relativi. Questi sono costituiti da ID raccolta e ID risorsa, strutturati in modo da indicare la loro gerarchia.

  • Un ID raccolta: una raccolta contiene risorse o altre raccolte.

Corse on demand

Tre raccolte: providers, vehicles e trips.

Attività pianificate

Tre raccolte: providers, deliveryVehicles e tasks.

Un ID risorsa: gli identificatori delle risorse nella documentazione di riferimento sono indicati da parentesi graffe nel campo del nome. Queste sono variabili per gli ID che fornisci quando invii una richiesta di creazione.

Corse on demand

  • {provider}: l'ID del tuo progetto Cloud. Creato una volta per progetto.
  • {vehicle}: la risorsa del veicolo, utilizzata per ogni creazione di veicolo, in genere riutilizzata per la stessa coppia conducente-veicolo.
  • {trip}: la risorsa del percorso, utilizzata per ogni percorso e in genere non riutilizzata.

Attività pianificate

  • {provider}: l'ID del tuo progetto Cloud. Viene creata una volta per progetto.
  • {vehicle}: la risorsa del veicolo per le consegne, utilizzata per ogni creazione di veicolo, in genere riutilizzata per la stessa coppia conducente-veicolo.
  • {task}: la risorsa dell'attività, utilizzata per ogni attività e in genere non riutilizzata.

Per ulteriori dettagli, consulta Nomi delle risorse nella documentazione delle API Google Cloud.

Log di Google Cloud per Fleet Engine

Fleet Engine offre un servizio di logging di base che ti consente di salvare le richieste API e i payload di risposta. Con questi log puoi eseguire il debug dell'integrazione, creare metriche di monitoraggio e analizzare i pattern di traffico.

Per maggiori dettagli, consulta Cloud Logging.

Come utilizzare Fleet Engine

1 Configura il progetto Cloud.

In questo passaggio, oltre ad abilitare le API correlate, crei una serie di ruoli per i service account.

Le API e gli SDK Fleet Engine richiedono l'utilizzo di JSON Web Token (JWT) firmati utilizzando gli account di servizio creati dalla console Cloud. Segui le istruzioni riportate in Crea il progetto Fleet Engine. Per comprendere meglio questi ruoli, consulta Ruoli dei service account.

2 Verifica la configurazione Dopo aver creato i service account, verifica che la configurazione sia completa e che tu possa creare un veicolo. Questo passaggio garantisce che tu abbia risolto i problemi di autorizzazione comuni che possono verificarsi durante la configurazione del progetto. Segui le indicazioni riportate in Verifica la configurazione.
3 Crea il tuo primo percorso Ciò comporta la creazione di un singolo veicolo con un insieme di coordinate che rappresentano le fermate lungo un percorso on demand o le attività pianificate. Per saperne di più, consulta i contenuti della panoramica relativi alle corse on demand o alle attività programmate.
4 Verifica la tua integrazione I servizi e i componenti di Fleet Engine richiedono dati in tempo reale da un parco veicoli. La progettazione, lo sviluppo e il deployment di app per una flotta di conducenti possono richiedere tempo. Per questo motivo, è meglio utilizzare prima i dati fittizi per esplorare l'integrazione prima di eseguire un deployment su larga scala. Per maggiori dettagli, consulta Configura Fleet Engine.

Passaggi successivi

  1. Comprendi i veicoli di Fleet Engine.
  2. Scopri di più sulle corse on demand o sulle attività pianificate.
  3. Configura Fleet Engine.