La documentazione in questa sezione mostra come creare e utilizzare i viaggi utilizzando il servizio di viaggi on demand di Google Maps Mobility. Si presuppone la conoscenza di quanto segue:
- Fleet Engine: devi conoscere i dettagli di implementazione , i meccanismi di richiesta e la sicurezza di Fleet Engine. Per questo, consulta 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 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 di corsa da parte dei tuoi consumatori. Un viaggio ha uno stato che viene segnalato 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ù sui viaggi e sulla loro relazione con i veicoli, consulta Viaggi on demand in Nozioni di base su Fleet
Engine.
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 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 presuppone che tu abbia configurato Fleet Engine e che tu abbia un veicolo da assegnare al viaggio, con gli aggiornamenti della posizione abilitati 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 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à del viaggio utilizzando
CreateTrip con i campi obbligatori, ad esempio la località di ritiro.
A questo punto può anche impostare altri campi, come passeggeri e
località di riconsegna, oppure attendere l'assegnazione di un veicolo. Consulta
Creare un viaggio con 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 Search Vehicle per cercare i veicoli, filtrando in base agli attributi del viaggio e del veicolo per trovare il veicolo migliore per completare il viaggio. Qualsiasi veicolo online all'interno del raggio di ricerca rende nota la sua vicinanza tramite gli aggiornamenti della posizione forniti dall'SDK driver. Una volta che |
| 3 | Aggiorna il viaggio. | Una volta che il conducente accetta il viaggio e inizia a navigare verso la
località di ritiro, il sistema aggiorna lo stato del viaggio 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 flusso continuo di aggiornamenti della posizione del veicolo dall'SDK driver. Il
sistema segnala quindi ogni traguardo del viaggio a Fleet Engine, che aggiorna
di conseguenza l'elenco delle tappe del veicolo.
|
| 4 | Condividi il viaggio con il consumatore. | Fleet Engine mette a disposizione dell'SDK consumer i dettagli del viaggio e la posizione del veicolo, che utilizza un listener per ricevere gli aggiornamenti del viaggio e visualizzarli nell'app per utenti finali. Fleet Engine aggiorna automaticamente l'orario di arrivo stimato, la distanza rimanente, i percorsi e le tappe rimanenti del veicolo. Per ulteriori informazioni, consulta Condividere i viaggi per i viaggi on demand. |
| 5 | Completa il viaggio. | Una volta che il veicolo raggiunge la tappa 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 visualizzazione più dettagliata di questo flusso.
