La documentazione in questa sezione mostra come creare e utilizzare i percorsi utilizzando il servizio di percorsi on demand di Google Maps Mobility. Presuppone la conoscenza di quanto segue:
- Fleet Engine: devi avere familiarità con 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 Configura 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 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, 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. Una corsa ha uno stato che segnali a Fleet Engine man mano che il percorso evolve, ad esempio NEW, ENROUTE_TO_PICKUP e altro ancora. Lo stato della corsa corrisponde ai waypoint geolocalizzati assegnati al veicolo e Fleet Engine modifica questi waypoint del veicolo a ogni aggiornamento della corsa che effettui. Per saperne di più sulle corse e sulla loro relazione con i veicoli, consulta Corse on demand in Nozioni di base su Fleet Engine.
Ciclo di vita 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 esempio di flusso end-to-end di una corsa creata nel tuo sistema e le fasi del suo ciclo di vita in Fleet Engine. Si presume che tu abbia configurato Fleet Engine e che tu abbia un veicolo da assegnare alla corsa, con gli aggiornamenti della posizione attivati nell'app per i conducenti. Consulta SDK Driver: corse on demand.
| 1 | Ricevi la richiesta di prenotazione. | Prima che inizi un percorso di Fleet Engine, il tuo sistema di prenotazione riceve una richiesta di corsa o consegna da un consumatore tramite la tua app o un altro sistema di prenotazione. Il tuo sistema crea quindi l'entità della corsa utilizzando
CreateTrip con i campi obbligatori, ad esempio la località di partenza.
In questa fase, può anche impostare altri campi, come i passeggeri e la località di arrivo, o attendere l'assegnazione di un veicolo. Consulta Crea un percorso con una sola destinazione. |
| 2 | Assegna 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 della corsa e del veicolo per trovare il veicolo migliore per completare il percorso. Qualsiasi veicolo online all'interno del raggio di ricerca rende nota la sua vicinanza tramite aggiornamenti della posizione forniti dall'SDK Driver. Una volta che |
| 3 | Aggiorna corsa. | 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 segnala quindi ogni tappa del percorso a Fleet Engine, che aggiorna di conseguenza l'elenco dei waypoint del veicolo.
|
| 4 | Condividi il percorso con il consumatore. | Fleet Engine rende disponibili i dettagli della corsa e la posizione del veicolo all'SDK Consumer, che utilizza un listener per ricevere gli aggiornamenti della corsa 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 | Completa la corsa. | Una volta che il veicolo raggiunge il waypoint di destinazione della corsa e il conducente indica che la corsa è andata a buon fine, il sistema imposta TripStatus su COMPLETE in Fleet Engine. Tieni presente che, come i veicoli, le entità corsa rimangono attive all'interno di Fleet Engine per 7 giorni, indipendentemente dallo stato, dopodiché vengono rimosse. |
Flusso della sequenza di corse
Il seguente diagramma mostra una visualizzazione più dettagliata di questo flusso.
