La documentazione in questa sezione mostra come creare e utilizzare i viaggi utilizzando il servizio di viaggi on demand di Google Maps Mobility. Si presume dimestichezza con quanto segue:
- Fleet Engine: devi conoscere i dettagli di implementazione di Fleet Engine, i meccanismi di richiesta e la sicurezza. A questo scopo, vedi Che cos'è il servizio Fleet Engine? e gli argomenti sulla sicurezza in Configurare Fleet Engine.
- Nozioni di base sui veicoli per i servizi on demand. Consulta Introduzione ai veicoli.
- Nozioni di base sui viaggi per i servizi on demand. Consulta la sezione Viaggi on demand.
Il 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 corsa da parte dei tuoi consumatori. Un viaggio
ha uno stato che segnali a Fleet Engine man mano che il viaggio si evolve, ad esempio
NEW
, ENROUTE_TO_PICKUP
e altri. Lo stato del viaggio corrisponde ai waypoint geolocalizzati assegnati al veicolo e Fleet Engine li modifica a ogni aggiornamento del viaggio. Per saperne di più sui viaggi e sulla loro relazione con i veicoli, consulta la sezione Viaggi on demand in Elementi fondamentali di Fleet Engine.
Durata di un viaggio
Per monitorare ogni corsa in Fleet Engine, devi prima creare un'entità Trip
. Per riferimento, consulta gRPC o REST.
La tabella seguente descrive un esempio di flusso end-to-end di un viaggio creato nel tuo sistema e le relative fasi del ciclo di vita in Fleet Engine. Si presume 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 Fleet Engine, il tuo sistema di prenotazione riceve innanzitutto la richiesta di una corsa o di una consegna da un consumatore tramite la tua app o un altro sistema di prenotazione. Il sistema crea quindi l'entità corsa utilizzando
CreateTrip con i campi obbligatori, come la stazione di partenza.
A questo punto può anche impostare altri campi, come i passeggeri e la località di destinazione, oppure attendere l'assegnazione di un veicolo. Consulta la pagina
Creare un viaggio di una sola destinazione. |
2 | Assegna il 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 di veicolo per trovare il veicolo migliore per completare il viaggio. Qualsiasi veicolo online all'interno del raggio di ricerca comunica la propria vicinanza tramite gli aggiornamenti della posizione forniti dall'SDK Driver. Una volta che |
3 | Aggiorna la corsa. | Una volta che il conducente accetta la corsa e inizia a dirigersi verso la località di ritiro, il sistema aggiorna lo stato della corsa da NEW
a ENROUTE_TO_PICKUP . Continua a eseguire il polling della posizione del veicolo
durante il viaggio, tramite una connessione diretta dall'app al tuo backend o eseguendo il polling di Fleet Engine, che riceve un
stream continuo di aggiornamenti della posizione del veicolo dall'SDK Driver. Il sistema poi segnala ogni traguardo del viaggio a Fleet Engine, che aggiorna di conseguenza l'elenco di waypoint del veicolo.
|
4 | Condividi il percorso con il consumatore. | Fleet Engine rende disponibili i dettagli della corsa e la posizione del veicolo per l'SDK consumer, che utilizza un listener per ricevere gli aggiornamenti della corsa e visualizzarli nell'app consumer. Fleet Engine aggiorna automaticamente l'orario di arrivo stimato, la distanza rimanente, i percorsi e i waypoint rimanenti del veicolo. Per ulteriori informazioni, consulta Condividere i percorsi per le corse on demand. |
5 | Completa il viaggio. | Quando il veicolo raggiunge il waypoint di destinazione del viaggio e il conducente 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à di 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 vista più dettagliata di questo flusso.