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 serie di API e SDK per migliorare la mappatura, il routing e la gestione della posizione.

Fleet Engine fornisce aggiornamenti di routing e stato per le entità dei veicoli modellate sul tuo parco veicoli reali. Man mano che il tuo sistema invia aggiornamenti sullo stato di avanzamento dei veicoli a Fleet Engine, Fleet Engine utilizza le informazioni sul routing e sulla posizione dei veicoli in tempo reale fornite dall'SDK Driver per fornire report accurati sui viaggi dei veicoli: orari di arrivo stimati, informazioni sul traffico e disponibilità dei veicoli.

Fleet Engine

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

  • Viaggi on demand: in questa offerta, Fleet Engine modella il ciclo di vita di un viaggio, dall'origine, passando per le fermate, fino alla destinazione. Nel ciclo di vita di un viaggio, un veicolo passa attraverso i luoghi di ritiro, i waypoint intermedi e i luoghi di riconsegna per soddisfare un viaggio prenotato da una richiesta del consumatore. Per informazioni dettagliate sui viaggi on demand, consulta la documentazione relativa ai viaggi 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 viaggio 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 Scheduled tasks.

Cosa puoi fare con Fleet Engine

Utilizzando i componenti di Fleet Engine, puoi:

  • Attivare il monitoraggio dei viaggi dei consumatori: per i viaggi on demand, puoi utilizzare le funzionalità dell'esperienza del consumatore di Fleet Engine e integrare l'SDK Consumer nelle tue app web o mobile. In questo modo, i tuoi consumatori possono utilizzare la stessa app per effettuare una richiesta di viaggio e monitorarne il percorso.
  • Fornire informazioni sui pacchi in tempo reale ai clienti: per le attività pianificate, puoi utilizzare le funzionalità dell'esperienza del consumatore di Fleet Engine e integrare l'SDK Consumer JavaScript nella tua app web. In questo modo, i tuoi 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.
  • Progettare 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 la giornata.
  • Migliorare l'esperienza dei conducenti: l'SDK Driver è un toolkit per app mobile e un componente fondamentale di Fleet Engine. Utilizza le funzionalità dei veicoli. Con questo SDK, la tua app di guida può gestire le assegnazioni di lavoro e attivare le funzionalità di navigazione e routing dei conducenti. Al suo interno, l'SDK utilizza un listener di eventi per inviare aggiornamenti sulla 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 una singola app per gestire le assegnazioni e navigare come se utilizzasse la versione consumer di Google Maps, ma senza dover passare a un'altra app.

Più in particolare, con queste soluzioni puoi fornire quanto segue:

Viaggi on demand

  • La posizione del veicolo del conducente allineata alla strada in tempo reale.
  • Il percorso effettivo del conducente con informazioni sul traffico in tempo reale.
  • L'orario di arrivo stimato per i luoghi di ritiro e riconsegna.
  • Monitoraggio dei viaggi singoli, con più destinazioni e consecutivi.
  • Viaggi in carpooling per più clienti sullo stesso percorso.
  • Elenco di tutti i veicoli in una regione specifica per trovare le corrispondenze migliori per i viaggi richiesti.

Attività pianificate

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

Come funziona Fleet Engine

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

Viaggi on demand

Il seguente diagramma mostra due parti chiave dei viaggi on demand: l' inizio della giornata in cui i conducenti attivano la condivisione della posizione con Fleet Engine e una visualizzazione semplificata della gestione dei viaggi utilizzando i componenti di Fleet Engine. Per una visualizzazione dettagliata della procedura di viaggio, consulta Che cos'è un viaggio? nella documentazione relativa ai viaggi on demand.

Attività pianificate

Il seguente diagramma mostra una matrice di una tipica giornata lavorativa di spedizione per un singolo conducente, nonché la gestione del suo lavoro nel sistema Fleet Engine utilizzando la libreria di monitoraggio del parco risorse.

Nota: il tuo sistema può utilizzare sia il monitoraggio delle spedizioni sia il monitoraggio del parco risorse. Con il monitoraggio delle spedizioni, Fleet Engine filtra le informazioni sulle spedizioni e sui conducenti 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 quanto segue:

  • Un veicolo: i viaggi 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 tue operazioni. In Fleet Engine, un'entità veicolo riceve le informazioni sulla posizione fornite dal veicolo reale associato tramite l'app del conducente integrata con l'SDK Driver. I veicoli Fleet Engine sono entità in gran parte parallele tra i due servizi, con alcune differenze. Leggi Introduzione ai veicoli per comprendere i veicoli in Fleet Engine.
  • L'SDK Driver: sia per le attività on demand sia per quelle pianificate, l'SDK Driver è un componente fondamentale. L'SDK Driver si integra con l'app del conducente e fornisce a Fleet Engine un flusso di aggiornamenti sulla posizione, nonché informazioni sul percorso su cui Fleet Engine si basa per segnalare lo stato in tempo reale del viaggio, insieme ad altre informazioni come l'orario di arrivo stimato e i dati sul traffico.
  • L'SDK Consumer: un vantaggio fondamentale sia per le attività on demand sia per quelle pianificate è l'SDK Consumer, utilizzato per comunicare al consumatore lo stato del suo viaggio, della consegna di cibo o della consegna di pacchi pianificata.

Viaggi on demand

Per una spiegazione di veicoli, viaggi e SDK, consulta la documentazione correlata per i viaggi on demand:

  1. Introduzione ai veicoli
  2. Viaggi on demand
  3. SDK Driver per viaggi on demand
  4. SDK Consumer per viaggi on demand

Attività pianificate

Per una spiegazione di veicoli di consegna, attività e SDK, consulta la documentazione correlata per le attività pianificate:

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

Risorse

Viaggi on demand

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

Attività pianificate

Veicolo di consegna
Risorse REST: providers.deliveryVehicles
gRPC: maps.delivery.v1
Nome risorsa providers/{provider}/deliveryVehicles/{vehicle}
Attività
Servizi REST: providers.tasks
gRPC: maps.fleetengine.delivery.v1.Task
Nome 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. Una parte del nome della risorsa è un ID risorsa, che fornisci quando invii una richiesta di creazione. Tuttavia, le risorse Fleet Engine non hanno un campo ID, ma piuttosto un campo nome di sola uscita, che include l'ID risorsa.

Fleet Engine utilizza nomi di 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.

Viaggi 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. Si tratta di variabili per gli ID che fornisci quando invii una richiesta di creazione.

Viaggi on demand

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

Attività pianificate

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

Per maggiori 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 i payload delle richieste e delle risposte delle API. 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, crei una serie di ruoli di service account, oltre ad attivare le API correlate.

Le API e gli SDK di Fleet Engine richiedono l'utilizzo di JSON Web Token (JWT) che sono stati firmati utilizzando i service account creati da Cloud Console. Segui le istruzioni riportate in Creare il progetto Fleet Engine. Per comprendere meglio questi ruoli, leggi 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 ti consente di risolvere i problemi di autorizzazione comuni che possono verificarsi durante la configurazione del progetto. Segui le istruzioni riportate in Verificare la configurazione.
3 Crea il tuo primo viaggio Questa operazione prevede la creazione di un singolo veicolo con un insieme di coordinate che rappresentano le fermate lungo un viaggio on demand o le attività pianificate. Per saperne di più, consulta i contenuti di panoramica per i viaggi on demand o le attività pianificate.
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 un parco di conducenti possono richiedere tempo. Per questo motivo, è consigliabile utilizzare prima i dati simulati per esplorare l'integrazione prima di eseguire un deployment su vasta scala. Per maggiori dettagli, consulta Configurare Fleet Engine.

Passaggi successivi

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