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, la creazione di percorsi e la gestione della posizione.

Fleet Engine fornisce aggiornamenti su percorsi e stato per le entità di veicoli modellate sul tuo parco veicoli reale. Quando il sistema invia aggiornamenti sull'avanzamento dei veicoli a Fleet Engine, Fleet Engine utilizza la posizione in tempo reale del veicolo e le informazioni sui percorsi 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 è compatibile 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 per le stazioni di partenza, i waypoint intermedi e le stazioni di arrivo per soddisfare una corsa prenotata su richiesta di 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 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:

  • Abilita il monitoraggio dei viaggi dei consumatori: per i viaggi on demand, puoi utilizzare le funzionalità dell'esperienza dei consumatori 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 monitorare il percorso.
  • Fornisci informazioni in tempo reale sui pacchetti per i clienti: per le attività programmate, puoi utilizzare le funzionalità per l'esperienza dei consumatori di Fleet Engine e integrare l'SDK consumer JavaScript nella tua app web. In questo modo, puoi fornire ai consumatori aggiornamenti quasi in tempo reale sullo stato dei loro pacchetti. L'SDK fornisce filtri e privacy dei dati integrati 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 JavaScript per il monitoraggio del parco risorse in modo che gli operatori del parco risorse possano coordinare e gestire meglio le assegnazioni dei veicoli durante la giornata.
  • Migliora l'esperienza dei tuoi autisti: l'SDK Driver è un kit di strumenti 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 i compiti e attivare le funzionalità di navigazione e routing per i conducenti. In sostanza, l'SDK utilizza un gestore di eventi per inviare aggiornamenti sulla posizione a Fleet Engine quando il tuo conducente inizia a guidare. Inoltre, invia indicatori a Fleet Engine sullo stato del veicolo. Con questo SDK, il conducente può utilizzare un'unica app per gestire i compiti e navigare come farebbe con la versione consumer di Google Maps, ma senza dover passare a un'altra app.

Nello specifico, con queste soluzioni puoi fornire quanto segue:

Viaggi on demand

  • La posizione in tempo reale del veicolo del conducente rilevata dalla strada.
  • Il percorso effettivo del conducente con informazioni sul traffico in tempo reale.
  • L'orario di arrivo stimato per le località di prelievo e di destinazione.
  • Monitoraggio per viaggi con una o più destinazioni e viaggi consecutivi.
  • Viaggi in car pooling per più clienti sullo stesso percorso.
  • Elenco di tutti i veicoli all'interno di una regione specifica per trovare le migliori corrispondenze per le corse richieste.

Attività pianificate

  • Aggiornamenti della posizione in tempo reale visualizzati sulla mappa.
  • Tempi di arrivo stimati regolati automaticamente in base alle circostanze in evoluzione, ad esempio il traffico.
  • Attività completate e fermate in attesa per fornire informazioni su possibili problemi.
  • Il numero di fermate e la distanza per aumentare la fiducia dei clienti.

Come funziona Fleet Engine

Questa sezione descrive una panoramica generale delle operazioni dei sistemi di 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 quando 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 autista, oltre a come il suo lavoro viene gestito nel sistema Fleet Engine utilizzando la libreria Fleet Tracking.

Nota: il sistema può utilizzare sia il monitoraggio delle spedizioni sia il monitoraggio della flotta. Con il monitoraggio delle spedizioni, Fleet Engine filtra le informazioni relative alla spedizione e al conducente in modo che un cliente visualizzi 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: le corse 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 informazioni sulla posizione fornite dal veicolo reale associato tramite l'app del conducente integrata con l'SDK Driver. I veicoli di Fleet Engine sono entità in gran parte parallele tra i due servizi, con alcune differenze. Leggi la sezione Introduzione ai veicoli per informazioni sui veicoli in Fleet Engine.
  • L'SDK Driver: sia per le attività on demand che per quelle pianificate, l'SDK Driver è un componente fondamentale. L'SDK Driver si integra con la tua app per i conducenti e fornisce a Fleet Engine uno stream di aggiornamenti della posizione insieme alle informazioni sul percorso su cui si basa Fleet Engine per segnalare lo stato in tempo reale del viaggio, oltre ad altre informazioni come l'orario di arrivo stimato e i dati sul traffico.
  • SDK Consumer: un vantaggio chiave sia per le attività on demand che per quelle pianificate è l'SDK Consumer, utilizzato per comunicare al consumatore lo stato della corsa, della consegna di cibo o della consegna pianificata del pacco.

Viaggi on demand

Per una spiegazione su veicoli, corse e SDK, consulta la documentazione correlata per le corse on demand:

  1. Introduzione ai veicoli
  2. Percorsi on demand
  3. SDK Driver per i viaggi on demand
  4. SDK consumer per le corse on demand

Attività pianificate

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

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

Risorse

Viaggi on demand

Veicolo
Servizi REST: v1.providers.vehicles
gRPC: maps.fleetengine.v1.VehicleService
Nome risorsa providers/{provider}/vehicles/{vehicle}
Percorso
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 unici chiamati names, forniti in formato stringa. Parte del nome della risorsa è un ID risorsa, che fornisci quando emetti una richiesta di creazione. Tuttavia, le risorse di Fleet Engine non hanno un campo ID, ma un campo del nome solo per l'output, che include l'ID risorsa.

Fleet Engine utilizza nomi delle risorse relativi. 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 tra parentesi graffe nel campo del nome. Si tratta di variabili per gli ID che fornisci quando emetti una richiesta di creazione.

Viaggi on demand

  • {provider}: il tuo ID progetto Cloud. Creato una volta per progetto.
  • {vehicle}: la risorsa del veicolo, utilizzata per ogni creazione di veicoli, tipicamente riutilizzata per la stessa coppia conducente-veicolo.
  • {trip}: la risorsa della corsa, utilizzata per ogni corsa e solitamente non riutilizzata.

Attività pianificate

  • {provider}: il tuo ID 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 di conducente e veicolo.
  • {task}: la risorsa dell'attività, utilizzata per ogni attività e in genere non riutilizzata.

Per maggiori dettagli, consulta la sezione 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 relativi payload di richieste e risposte dell'API. Con questi log, puoi eseguire il debug dell'integrazione, creare metriche di monitoraggio e analizzare i modelli 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 dell'account di servizio, oltre ad attivare le API correlate.

Le API e gli SDK di Fleet Engine richiedono l'utilizzo di token web JSON (JWT) che sono stati firmati utilizzando account di servizio creati dalla console Cloud. Segui le istruzioni riportate in Creare il progetto Fleet Engine. Per comprendere meglio questi ruoli, consulta la sezione Ruoli degli account di servizio.

2 Verificare la configurazione Dopo aver creato gli account di servizio, verifica che la configurazione sia completata e che tu possa creare un veicolo. Questo passaggio ti consente di verificare di aver risolto i problemi di autorizzazione comuni che possono verificarsi durante la configurazione del progetto. Segui le istruzioni riportate nella sezione Verificare la configurazione.
3 Creare il tuo primo percorso Ciò comporta 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 le corse on demand o le attività pianificate.
4 Testare l'integrazione I servizi e i componenti di Fleet Engine richiedono dati in tempo reale di un parco di veicoli. La progettazione, lo sviluppo e il deployment di app per un parco di autotrasportatori possono richiedere tempo. Per questo motivo, è meglio utilizzare prima dati simulati per esplorare l'integrazione prima di eseguire un deployment completo. Per maggiori dettagli, consulta Configurare Fleet Engine.

Passaggi successivi

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