Что такое поездка по требованию?

Документация в этом разделе показывает, как создавать и работать с поездками с помощью сервиса поездок по запросу Google Maps Mobility. Предполагается знакомство со следующим:

• Fleet Engine : Вы должны быть знакомы с деталями реализации Fleet Engine, механизмами запросов и безопасностью. Для этого см. Что такое служба Fleet Engine? и темы безопасности в разделе Настройка Fleet Engine .
• Основы транспортных средств для услуг по требованию. См. Введение в транспортные средства .
• Основы поездок для услуг по запросу. См. Поездки по запросу .

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 автоматически обновляет ETA, оставшееся расстояние, маршруты и оставшиеся путевые точки транспортного средства. См. Share journeys для поездок по запросу для получения дополнительной информации.
5	Полное путешествие.	Как только транспортное средство достигает конечной точки маршрута поездки и ваш водитель указывает на успешную поездку, ваша система устанавливает TripStatus на COMPLETE в Fleet Engine. Помните, что, как и транспортные средства, объекты поездок остаются активными в Fleet Engine в течение 7 дней независимо от статуса, после чего они удаляются.

Последовательность выполнения поездки

На следующей диаграмме показан более подробный вид этого потока.

Что дальше?

• Создайте поездку в один пункт назначения