La documentazione in questa sezione mostra come creare e utilizzare i viaggi utilizzando il servizio di viaggi on demand di Google Maps Mobility. Presuppone familiarità con quanto segue:
- Fleet Engine: devi conoscere i dettagli di implementazione, i meccanismi di richiesta e la sicurezza di Fleet Engine. Per farlo, consulta Che cos'è il servizio Fleet Engine? e gli argomenti relativi alla sicurezza in Configurare Fleet Engine.
- Nozioni di base sui veicoli per i servizi on demand. Consulta Introduzione ai veicoli.
- Informazioni di base sul viaggio per i servizi on demand. Vedi Corse on demand.
TripService che utilizzerai è disponibile per gRPC e REST.
Per semplicità, i riferimenti ai campi seguono la convenzione gRPC.
In Fleet Engine per i servizi on demand, un viaggio è un tipo di percorso che modella
l'evasione di una richiesta di consegna di cibo o di corsa da parte dei tuoi consumatori. Un viaggio
ha uno stato che viene comunicato a Fleet Engine man mano che il viaggio procede, ad esempio
NEW, ENROUTE_TO_PICKUP e altro ancora. Lo stato del viaggio corrisponde alle tappe geolocalizzate assegnate al veicolo e Fleet Engine modifica queste tappe del veicolo a ogni aggiornamento del viaggio che effettui. Per saperne di più sui viaggi e sul loro rapporto con i veicoli, consulta la sezione Viaggi on demand in Fleet
Engine Essentials.
Durata di un viaggio
Per monitorare ogni viaggio in Fleet Engine, devi prima creare un'entità Trip. Per riferimento, consulta gRPC o REST.
La tabella seguente descrive un flusso end-to-end di esempio di un viaggio creato nel tuo sistema e le relative fasi del ciclo di vita in Fleet Engine. Presuppone che tu abbia configurato Fleet Engine e che tu abbia un veicolo da assegnare al viaggio, con gli aggiornamenti della posizione attivati nell'app del conducente. Consulta SDK driver: viaggi on demand.
| 1 | Ricevi la richiesta di prenotazione. | Prima dell'inizio di un viaggio di Fleet Engine, il tuo sistema di prenotazione riceve prima una
richiesta di corsa o consegna da un consumatore tramite la tua app o un altro
sistema di prenotazione. Il sistema crea quindi l'entità viaggio utilizzando
CreateTrip con i campi obbligatori, ad esempio il luogo di ritiro.
A questo punto può anche impostare altri campi, come passeggeri e
destinazione, oppure attendere l'assegnazione di un veicolo. Vedi
Creare un viaggio con una sola destinazione. |
| 2 | Assegna veicolo. | Puoi assegnare i veicoli ai viaggi direttamente all'interno del tuo sistema e segnalare l'assegnazione a Fleet Engine oppure puoi utilizzare il servizio Cerca veicolo per cercare i veicoli, filtrando in base agli attributi di viaggio e veicolo per trovare il veicolo migliore per completare il viaggio. Qualsiasi veicolo online nel raggio di ricerca comunica la propria vicinanza tramite gli aggiornamenti della posizione forniti dall'SDK Driver. Quando |
| 3 | Aggiorna viaggio. | Una volta che l'autista accetta la corsa e inizia a navigare verso il
luogo di partenza, il sistema aggiorna lo stato della corsa da NEW
a ENROUTE_TO_PICKUP. Continui a eseguire il polling della posizione del veicolo
durante il viaggio, tramite una connessione diretta dall'app al backend o eseguendo il polling di Fleet Engine, che riceve un flusso continuo di aggiornamenti della posizione del veicolo dall'SDK Driver. Il tuo
sistema segnala quindi ogni traguardo del viaggio a Fleet Engine, che aggiorna
l'elenco delle tappe del veicolo di conseguenza.
|
| 4 | Condividi il percorso con il consumatore. | Fleet Engine rende disponibili i dettagli del viaggio e la posizione del veicolo all'SDK consumer, che utilizza un listener per ricevere gli aggiornamenti del viaggio e visualizzarli nell'app consumer. Fleet Engine aggiorna automaticamente l'ETA, la distanza rimanente, i percorsi e i waypoint rimanenti del veicolo. Per saperne di più, consulta Condividere i viaggi per le corse on demand. |
| 5 | Viaggio completo. | Una volta che il veicolo raggiunge il waypoint di destinazione del viaggio e l'autista indica che il viaggio è andato a buon fine, il sistema imposta TripStatus su COMPLETE in Fleet Engine. Tieni presente
che, come i veicoli, le entità viaggio rimangono attive in Fleet Engine
per 7 giorni indipendentemente dallo stato, dopodiché vengono rimosse. |
Flusso della sequenza di viaggio
Il seguente diagramma mostra una visualizzazione più dettagliata di questo flusso.
