Fleet Engine è un servizio di backend che si integra con il sistema che utilizzi per gestire i servizi di trasporto per i tuoi clienti. È interoperabile con una varietà di API e SDK per migliorare la mappatura, il calcolo del percorso e la gestione della posizione.
Fleet Engine fornisce aggiornamenti su itinerari e stato per le entità dei veicoli modellate sulla tua flotta di veicoli reali. Man mano che il sistema invia aggiornamenti sull'avanzamento del veicolo a Fleet Engine, quest'ultimo utilizza la posizione del veicolo in tempo reale e le informazioni sul percorso fornite dal Driver SDK per fornire report accurati sui viaggi del veicolo: ETA, informazioni sul traffico e disponibilità del veicolo.
Il servizio Fleet Engine funziona con entrambe le seguenti offerte di Mobility Service:
- 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 per i luoghi di ritiro, i waypoint intermedi e i luoghi di destinazione per soddisfare una richiesta di viaggio prenotata 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 di 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 Attività pianificate.
Cosa puoi fare con Fleet Engine
Utilizzando i componenti di Fleet Engine, puoi:
- Attiva 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 mobile o web. In questo modo, i tuoi consumatori possono utilizzare la stessa app per effettuare una richiesta di viaggio e monitorarne il percorso.
- Fornisci informazioni sui pacchi in tempo reale ai clienti: per le attività pianificate, puoi utilizzare le funzionalità dell'esperienza utente di Fleet Engine e integrare l'SDK consumer JavaScript nella tua app web. In questo modo, i tuoi clienti possono ricevere aggiornamenti quasi in tempo reale sullo stato dei loro pacchi. L'SDK fornisce filtri e privacy dei dati integrati in modo che i consumatori vedano solo le informazioni pertinenti al loro ordine.
- Progetta soluzioni per gli operatori di flotte: per le attività pianificate, utilizza la libreria di monitoraggio della flotta JavaScript in modo che gli operatori di flotte possano coordinare e gestire meglio le assegnazioni dei veicoli durante la giornata.
- Migliora l'esperienza dei tuoi autisti: l'SDK Driver è un toolkit per app mobile e un componente fondamentale di Fleet Engine. Utilizza funzionalità di vehicles. Con questo SDK, la tua app di guida può gestire le assegnazioni di lavoro e attivare le funzionalità di navigazione e itinerario per i conducenti. Fondamentalmente, l'SDK utilizza un listener di eventi per inviare aggiornamenti della posizione a Fleet Engine quando l'autista inizia a guidare. Inoltre, invia indicatori a Fleet Engine sullo stato del veicolo. Con questo SDK, l'autista può utilizzare una sola app per gestire gli incarichi 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:
Viaggi on demand
- La posizione in tempo reale del veicolo del conducente.
- Il percorso effettivo dell'autista con informazioni sul traffico in tempo reale.
- L'orario di arrivo stimato per le località di prelievo e destinazione.
- Monitoraggio di viaggi singoli, con più destinazioni e consecutivi.
- Corse in carpooling per più clienti sullo stesso percorso.
- Elencando 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.
- ETA regolate automaticamente in base alle mutevoli circostanze, come il traffico.
- Attività completate e soste in attesa per fornire informazioni su possibili problemi.
- Il numero di fermate e la distanza, in modo che i clienti abbiano maggiore confidenza.
Come funziona Fleet Engine
Questa sezione descrive 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, 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, vedi 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, nonché il modo in cui il suo lavoro viene gestito nel sistema Fleet Engine utilizzando la libreria 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 su spedizioni e autisti 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 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 informazioni sulla posizione fornite dal veicolo reale associato tramite l'app per i conducenti integrata con il Driver SDK. I veicoli Fleet Engine sono in gran parte entità parallele tra i due servizi, con alcune differenze. Leggi la Introduzione ai veicoli per comprendere i veicoli in Fleet Engine.
- L'SDK Driver: per le attività on demand e pianificate, l'SDK Driver è un componente fondamentale. 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 viaggio, insieme ad altre informazioni come l'ETA e i dati sul traffico.
- SDK per i consumatori: un vantaggio fondamentale sia per le attività on demand che per quelle pianificate è l'SDK per i consumatori, utilizzato per comunicare al consumatore lo stato della corsa, della consegna di cibo o della consegna di pacchi pianificata.
Viaggi on demand
Per una spiegazione su veicoli, viaggi e SDK, consulta la documentazione correlata per le corse on demand:
Attività pianificate
Per una spiegazione su veicoli di consegna, attività e SDK, consulta la documentazione correlata 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} |
|
| Viaggio | ||
| Servizi | REST: v1.providers.trips
gRPC: maps.fleetengine.v1.TripService |
|
| Nome risorsa | providers/{provider}/trips/{trip} |
|
Attività pianificate
| Veicolo per le consegne | ||
|---|---|---|
| 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. 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 un
campo nome di sola output, che include l'ID risorsa.
Fleet Engine utilizza nomi di risorse relativi. Questi ID 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 dalle parentesi graffe nel campo del nome. Queste sono variabili per gli ID che fornisci quando invii 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 veicolo, in genere riutilizzata per la stessa coppia conducente-veicolo.{trip}: la risorsa di viaggio, utilizzata per ogni viaggio e non in genere 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 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 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 le richieste API e i payload di risposta. Con questi log, puoi eseguire il debug dell'integrazione, creare metriche di monitoraggio e analizzare i modelli di traffico.
Per i dettagli, consulta Cloud Logging.
Come utilizzare Fleet Engine
| 1 | Configura il progetto cloud. | In questo passaggio crei una serie di ruoli per l'account di servizio, oltre ad abilitare le API correlate. Le API e gli SDK di Fleet Engine richiedono l'utilizzo di token web JSON (JWT) firmati utilizzando account di servizio creati dalla console Google Cloud. Segui le istruzioni riportate in Creare il progetto Fleet Engine. Per comprendere meglio questi ruoli, leggi la sezione Ruoli del service account. |
| 2 | Verificare la configurazione | Dopo aver creato gli account di servizio, 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 indicazioni 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 una corsa on demand o le attività pianificate. Per saperne di più, consulta i contenuti della panoramica relativi alle corse on demand o alle attività pianificate. |
| 4 | Testare l'integrazione | I servizi e i componenti di Fleet Engine richiedono dati in tempo reale da una flotta di veicoli. La progettazione, lo sviluppo e il deployment di app per una flotta di autisti possono richiedere tempo. Per questo motivo, è consigliabile utilizzare prima dati simulati per esplorare l'integrazione prima di eseguire un deployment su larga scala. Per maggiori dettagli, vedi Configurare Fleet Engine. |
Passaggi successivi
- Comprendi i veicoli Fleet Engine.
- Scopri di più sulle corse on demand o sulle attività pianificate.
- Configura Fleet Engine.