Что такое поездка по требованию?
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
В этом разделе представлена документация, описывающая создание и работу с маршрутами с помощью сервиса поездок по запросу Google Maps Mobility. Предполагается, что вы знакомы со следующими аспектами:
TripService , который вы будете использовать, доступен для gRPC и REST . Для простоты ссылки на поля соответствуют правилам gRPC.
В Fleet Engine для услуг по запросу поездка — это тип поездки, моделирующий выполнение заказа на доставку еды или поездку от ваших клиентов. У поездки есть статус, который вы сообщаете Fleet Engine по мере её развития, например, NEW , ENROUTE_TO_PICKUP ) и другие. Статус поездки соответствует геолокированным путевым точкам, назначенным транспортному средству, и Fleet Engine изменяет эти путевые точки с каждым обновлением данных о поездке. Подробнее о поездках и их связи с транспортными средствами см. в разделе «Поездки по запросу» в разделе «Основные сведения о Fleet Engine» .
Жизнь как путешествие
Чтобы отслеживать каждую поездку в Fleet Engine, необходимо сначала создать объект Trip . См. gRPC или REST для справки.
В таблице ниже описан пример сквозного процесса поездки, созданной в вашей системе, и этапы её жизненного цикла в Fleet Engine. Предполагается, что вы настроили Fleet Engine и у вас есть автомобиль для назначения на поездку, а в приложении водителя включены обновления местоположения. См. Driver SDK: Поездки по требованию .
| 1 | Получите запрос на бронирование. | Перед началом поездки Fleet Engine ваша система бронирования получает запрос на поездку или доставку от клиента через ваше приложение или другую систему бронирования. Затем система создаёт объект поездки с помощью CreateTrip с обязательными полями, такими как место посадки. На этом этапе она также может указать другие поля, например, количество пассажиров и место высадки, или дождаться назначения транспортного средства. См. раздел Создание поездки с одним пунктом назначения . |
| 2 | Назначить транспортное средство. | Вы можете либо назначать автомобили на рейсы непосредственно в своей системе и сообщать о назначении в Fleet Engine, либо использовать сервис поиска автомобилей , фильтруя автомобили по параметрам как поездки, так и самого автомобиля, чтобы найти оптимальный вариант. Любой автомобиль, находящийся онлайн в радиусе поиска, сообщает о своей близости с помощью обновлений местоположения, предоставляемых Driver SDK. Как только SearchVehicle возвращает транспортное средство, сопоставленное с поездкой, ваша система вызывает конечную точку UpdateTrip , чтобы сообщить идентификатор транспортного средства, назначенный вами NEW поездке. |
| 3 | Обновление поездки. | Как только водитель принимает заказ и начинает движение к месту посадки, ваша система обновляет статус поездки с NEW на ENROUTE_TO_PICKUP . Вы продолжаете опрашивать местоположение автомобиля на протяжении всей поездки, либо через прямое подключение приложения к вашей серверной части, либо опрашивая Fleet Engine, который получает непрерывный поток обновлений местоположения автомобиля от Driver SDK. Затем ваша система сообщает о каждом этапе поездки во Fleet Engine, который соответствующим образом обновляет список путевых точек автомобиля. |
| 4 | Поделитесь путешествием с потребителем. | Fleet Engine предоставляет информацию о поездке и местоположении транспортного средства в Consumer SDK, который использует прослушиватель для получения обновлений о поездке и отображения их в потребительском приложении. Fleet Engine автоматически обновляет данные о времени прибытия, оставшемся расстоянии, маршрутах и оставшихся точках маршрута транспортного средства. Подробнее см. в разделе «Поделиться поездками» для поездок по запросу . |
| 5 | Полное путешествие. | Как только транспортное средство достигает конечной точки маршрута и ваш водитель сообщает об успешном завершении поездки, система устанавливает TripStatus в Fleet Engine на COMPLETE . Имейте в виду, что, как и транспортные средства, объекты поездок остаются активными в Fleet Engine в течение 7 дней независимо от статуса, после чего они удаляются. |
Последовательность действий при поездке
На следующей диаграмме представлен более подробный вид этого потока.
Что дальше?
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-08-29 UTC.
[null,null,["Последнее обновление: 2025-08-29 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)"]]
