Che cos'è un viaggio on demand?
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
La documentazione in questa sezione mostra come creare e utilizzare i viaggi utilizzando
il servizio di viaggi on demand di Google Maps Mobility. Presuppone familiarità con
quanto segue:
L'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. Consulta la sezione Viaggi on demand in Fleet
Engine essentials per saperne di più sui viaggi e sul loro rapporto con i veicoli.
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 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 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à viaggio utilizzando
CreateTrip con i campi obbligatori, come la posizione di ritiro.
A questo punto può anche impostare altri campi, come passeggeri e
posizione di rilascio, o attendere l'assegnazione di un veicolo. Vedi
Creare un viaggio con una sola destinazione. |
| 2 |
Assegna 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 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.
Quando SearchVehicle restituisce un veicolo che corrisponde a un viaggio, il tuo sistema chiama l'endpoint UpdateTrip per segnalare l'ID veicolo che hai assegnato al viaggio NEW.
|
| 3 |
Aggiorna corsa. |
Una volta che l'autista accetta la corsa e inizia a navigare verso il
luogo 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 il viaggio, tramite una connessione diretta dall'app
al 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 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 viaggio e la posizione del veicolo
all'SDK consumer, che utilizza un listener per ricevere gli aggiornamenti del viaggio 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 saperne di più, consulta Condividere i viaggi per le corse on demand. |
| 5 |
Viaggio completato. |
Una volta che il veicolo raggiunge il waypoint di destinazione del viaggio e l'autista 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à viaggio 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.
Passaggi successivi
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-31 UTC.
[null,null,["Ultimo aggiornamento 2025-08-31 UTC."],[[["\u003cp\u003eThis documentation provides a comprehensive guide on utilizing the Google Maps Mobility on-demand trips service for managing and tracking trips.\u003c/p\u003e\n"],["\u003cp\u003eYou should have a foundational understanding of Fleet Engine, Vehicle Basics, and Trip Basics for on-demand services.\u003c/p\u003e\n"],["\u003cp\u003eFleet Engine's \u003ccode\u003eTripService\u003c/code\u003e enables the creation, assignment, updating, and completion of trips through gRPC or REST.\u003c/p\u003e\n"],["\u003cp\u003eTrips represent journeys fulfilling consumer requests, evolving through various statuses like \u003ccode\u003eNEW\u003c/code\u003e, \u003ccode\u003eENROUTE_TO_PICKUP\u003c/code\u003e, and \u003ccode\u003eCOMPLETE\u003c/code\u003e, influencing vehicle waypoints.\u003c/p\u003e\n"],["\u003cp\u003eThe trip lifecycle includes booking, vehicle assignment, status updates, consumer journey sharing, and completion, all managed through Fleet Engine interactions.\u003c/p\u003e\n"]]],[],null,["The documentation in this section shows how to create and work with trips using\nthe Google Maps Mobility on-demand trips service. It assumes familiarity with\nthe following:\n\n- **Fleet Engine** : You should be familiar with Fleet Engine implementation details, request mechanisms, and security. For that, see [What is the Fleet\n Engine service?](/maps/documentation/mobility/fleet-engine/essentials) and the security topics in [Set up Fleet Engine](/maps/documentation/mobility/fleet-engine/essentials/set-up-fleet).\n- **Vehicles basics** for on-demand services. See [Introduction to vehicles](/maps/documentation/mobility/fleet-engine/essentials/vehicles-intro).\n- **Trip basics** for on-demand services. See [On-demand trips](/maps/documentation/mobility/fleet-engine/essentials/trip-intro).\n\nThe `TripService` that you'll use is available for [gRPC](/maps/documentation/mobility/fleet-engine/reference/trips/rpc/maps.fleetengine.v1#tripservice) and [REST](/maps/documentation/mobility/fleet-engine/reference/trips/rest/v1/providers.trips).\nFor simplicity sake, field references follow the gRPC convention.\n\nIn Fleet Engine for on-demand services, a trip is a type of journey that models\nthe fulfillment of a food delivery or ride request from your consumers. A trip\nhas a status that you report to Fleet Engine as the journey evolves, such as\n`NEW`, `ENROUTE_TO_PICKUP`, and more. The trip status corresponds to geo-located\nwaypoints assigned to the vehicle, and Fleet Engine modifies these vehicle\nwaypoints with each trip update you make. See [On demand trips](/maps/documentation/mobility/fleet-engine/essentials/trip-intro) in **Fleet\nEngine essentials** for more about trips and their relationship to vehicles.\n\nLife of a trip\n\nIn order to track each trip in Fleet Engine, you must first create a `Trip`\nentity. See either [gRPC](/maps/documentation/mobility/fleet-engine/reference/trips/rpc/maps.fleetengine.v1#maps.fleetengine.v1.Trip) or [REST](/maps/documentation/mobility/fleet-engine/reference/trips/rest/v1/providers.trips) for reference.\n\nThe following table describes an example end-to-end flow of a trip created in\nyour system and its lifecycle stages in Fleet Engine. It assumes you have set up\nFleet Engine and have a vehicle to assign to the trip, with location updates\nenabled in the driver app. See [Driver SDK: On-demand trips](/maps/documentation/mobility/driver-sdk/on-demand).\n\n|---|----------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Receive booking request.** | Before a Fleet Engine trip begins, your booking system first receives a request for a ride or delivery from a consumer through your app or other booking system. Your system then creates the trip entity using `CreateTrip` with required fields, such as the pickup location. It can also set other fields at this point, such passengers and dropoff location, or wait until it assigns a vehicle. See [Create a single-destination trip](/maps/documentation/mobility/fleet-engine/journeys/trips/create-trip). |\n| 2 | **Assign vehicle.** | You can either assign vehicles to trips directly within your system and report the assignment to Fleet Engine, or you can use the [Search Vehicle](/maps/documentation/mobility/fleet-engine/essentials/vehicles/on-demand-search-vehicle) service to search for vehicles, filtering by both trip and vehicle attributes to find the best vehicle to complete the journey. Any online vehicle within your search radius makes their proximity known through location updates provided by the Driver SDK. Once `SearchVehicle` returns a vehicle that you match to a trip, your system calls the `UpdateTrip` endpoint to report the vehicle ID you assigned to the `NEW` trip. |\n| 3 | **Update trip.** | Once the driver accepts the trip and begins navigating to the pickup location, your system updates the trip status from `NEW` to `ENROUTE_TO_PICKUP`. You continue to poll the vehicle location throughout the journey, either through a direct connection from the app to your backend, or by polling Fleet Engine, which receives an ongoing stream of vehicle location updates from the Driver SDK. Your system then reports each journey milestone to Fleet Engine, which updates the vehicle's waypoint list accordingly. |\n| 4 | **Share journey with consumer.** | Fleet Engine makes trip details and vehicle location available to the Consumer SDK, which uses a listener to receive trip updates and display them in the consumer app. Fleet Engine automatically updates ETA, remaining distance, routes, and remaining vehicle waypoints. See [Share journeys for on-demand trips](/maps/documentation/mobility/journey-sharing/on-demand) for more information. |\n| 5 | **Complete trip.** | Once the vehicle reaches the destination waypoint of the trip and your driver indicates a successful trip, your system sets the `TripStatus` to `COMPLETE` in Fleet Engine. Keep in mind that, like vehicles, trip entities remain active within Fleet Engine for 7 days regardless of status, at which point they are removed. |\n\nTrip sequence flow\n\nThe following diagram shows a more detailed view of this flow.\n\nWhat's next\n\n- [Create a single-destination trip](/maps/documentation/mobility/fleet-engine/journeys/trips/create-trip)"]]
