Документация в этом разделе показывает, как создавать и работать с поездками с помощью сервиса поездок по запросу 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. Как только |
| 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 дней независимо от статуса, после чего они удаляются. |
Последовательность выполнения поездки
На следующей диаграмме показан более подробный вид этого потока.
Что дальше?
,Документация в этом разделе показывает, как создавать и работать с поездками с помощью сервиса поездок по запросу 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. Как только |
| 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 дней независимо от статуса, после чего они удаляются. |
Последовательность выполнения поездки
На следующей диаграмме показан более подробный вид этого потока.