Che cos'è un viaggio on demand?

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:

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 SearchVehicle restituisce un veicolo associato a un viaggio, il sistema chiama l'endpoint UpdateTrip per segnalare l'ID del veicolo assegnato al viaggio NEW.

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.

TripSequenceDiagram

Passaggi successivi