La documentazione in questa sezione mostra come creare e utilizzare i percorsi con il servizio di percorsi 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.
- Nozioni di base sui percorsi per i servizi on demand. Consulta 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, una corsa è 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 percorso evolve, 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. Per saperne di più sulle corse e sulla loro relazione con i veicoli, consulta Corse on demand in Concetti essenziali di Fleet Engine.
Durata di una corsa
Per monitorare ogni percorso 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 una corsa di Fleet Engine, il tuo sistema di prenotazione riceve innanzitutto 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. Consulta Crea un viaggio con una sola destinazione. |
| 2 | Assegna il veicolo. | Puoi assegnare i veicoli alle corse 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 corsa e veicolo per trovare il veicolo migliore per completare il viaggio. Qualsiasi veicolo online nel raggio di ricerca rende nota la sua vicinanza tramite gli aggiornamenti della posizione forniti dall'SDK Driver. Una volta che |
| 3 | Aggiorna viaggio. | Una volta che il conducente accetta la corsa e inizia a navigare verso la località 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 tutto il percorso, tramite una connessione diretta dall'app al tuo 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
comunica 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 percorso e la posizione del veicolo all'SDK Consumer, che utilizza un listener per ricevere gli aggiornamenti del percorso e visualizzarli nell'app per utenti finali. Fleet Engine aggiorna automaticamente l'orario di arrivo stimato, la distanza rimanente, i percorsi e i waypoint rimanenti del veicolo. Per saperne di più, consulta Condividi i percorsi per le corse on demand. |
| 5 | Viaggio completo. | Una volta che il veicolo raggiunge il waypoint di destinazione della corsa e il conducente indica che la corsa è stata completata, il sistema imposta TripStatus su COMPLETE in Fleet Engine. Tieni presente che, come i veicoli, le entità di percorso rimangono attive in Fleet Engine per 7 giorni, indipendentemente dallo stato, dopodiché vengono rimosse. |
Flusso della sequenza di viaggi
Il seguente diagramma mostra una visualizzazione più dettagliata di questo flusso.
