Co to jest podróż na żądanie?
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Dokumentacja w tej sekcji pokazuje, jak tworzyć przejazdy i z nich korzystać za pomocą usługi Google Maps Mobility on-demand trips. Zakładamy, że znasz te pojęcia:
TripService, którego będziesz używać, jest dostępny w przypadku gRPC i REST.
Dla uproszczenia odwołania do pól są zgodne z konwencją gRPC.
W usłudze Fleet Engine dla usług na żądanie przejazd to rodzaj podróży, który modeluje realizację zamówienia dostawy jedzenia lub przejazdu od konsumentów. Podróż ma stan, który zgłaszasz do Fleet Engine w miarę jej postępu, np. NEW, ENROUTE_TO_PICKUP i inne. Stan przejazdu odpowiada przypisanym do pojazdu punktom trasy z określoną lokalizacją geograficzną. Fleet Engine modyfikuje te punkty trasy pojazdu przy każdej aktualizacji przejazdu. Więcej informacji o przejazdach i ich związku z pojazdami znajdziesz w sekcji Przejazdy na żądanie w artykule Podstawowe informacje o Fleet Engine.
Cykl życia podróży
Aby śledzić każdy przejazd w Fleet Engine, musisz najpierw utworzyć Trip. Więcej informacji znajdziesz w sekcjach gRPC i REST.
W tabeli poniżej opisano przykładowy kompleksowy przepływ przejazdu utworzonego w Twoim systemie oraz etapy jego cyklu życia w Fleet Engine. Zakładamy, że masz już skonfigurowany Fleet Engine i pojazd, który można przypisać do przejazdu, a w aplikacji kierowcy włączone są aktualizacje lokalizacji. Więcej informacji znajdziesz w artykule Pakiet sterowników SDK: przejazdy na żądanie.
| 1 |
Otrzymujesz prośbę o rezerwację. |
Zanim rozpocznie się przejazd w Fleet Engine, Twój system rezerwacji najpierw otrzymuje od klienta prośbę o przejazd lub dostawę za pomocą Twojej aplikacji lub innego systemu rezerwacji. System tworzy wtedy element podróży za pomocą
CreateTrip z wymaganymi polami, takimi jak miejsce odbioru.
Może też ustawić inne pola, np. liczbę pasażerów i miejsce docelowe, lub poczekać, aż przypisze pojazd. Zobacz Tworzenie wycieczki do jednego miejsca docelowego. |
| 2 |
Przypisz pojazd. |
Możesz przypisywać pojazdy do przejazdów bezpośrednio w swoim systemie i zgłaszać przypisanie do Fleet Engine lub używać usługi Wyszukiwanie pojazdu do wyszukiwania pojazdów, filtrując je według atrybutów przejazdu i pojazdu, aby znaleźć najlepszy pojazd do odbycia przejazdu. Każdy pojazd online w promieniu wyszukiwania informuje o swojej bliskości za pomocą aktualizacji lokalizacji dostarczanych przez pakiet Driver SDK.
Gdy SearchVehicle zwróci pojazd pasujący do przejazdu, Twój system wywoła punkt końcowy UpdateTrip, aby zgłosić identyfikator pojazdu przypisany do przejazdu NEW.
|
| 3 |
Aktualizuj podróż |
Gdy kierowca zaakceptuje przejazd i rozpocznie nawigację do miejsca odbioru, system zmieni stan przejazdu z NEW na ENROUTE_TO_PICKUP. Podczas przejazdu nadal sprawdzasz lokalizację pojazdu, korzystając z bezpośredniego połączenia aplikacji z backendem lub z Fleet Engine, który otrzymuje ciągły strumień aktualizacji lokalizacji pojazdu z pakietu Driver SDK. Twój system zgłasza następnie każdy etap podróży do Fleet Engine, który odpowiednio aktualizuje listę punktów na trasie pojazdu.
|
| 4 |
Udostępnianie ścieżki konsumentowi. |
Fleet Engine udostępnia szczegóły podróży i lokalizację pojazdu pakietowi Consumer SDK, który używa odbiornika do otrzymywania aktualizacji podróży i wyświetlania ich w aplikacji konsumenckiej. Fleet Engine automatycznie aktualizuje szacowany czas przyjazdu, pozostałą odległość, trasy i pozostałe punkty pośrednie pojazdu. Więcej informacji znajdziesz w artykule Udostępnianie przejazdów w przypadku przejazdów na żądanie. |
| 5 |
Zakończ podróż. |
Gdy pojazd dotrze do punktu docelowego przejazdu, a kierowca potwierdzi, że przejazd się powiódł, system ustawi w Fleet Engine wartość TripStatus na COMPLETE. Pamiętaj, że podobnie jak pojazdy, obiekty podróży pozostają aktywne w Fleet Engine przez 7 dni niezależnie od stanu, po czym są usuwane. |
Proces sekwencji podróży
Poniższy diagram przedstawia bardziej szczegółowy widok tego procesu.
Co dalej?
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-31 UTC.
[null,null,["Ostatnia aktualizacja: 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)"]]
