В этом разделе описана процедура создания и работы с поездками с помощью сервиса поездок по запросу 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 Essentials для получения дополнительной информации о поездках и их связи с транспортными средствами.
Жизнь путешествия
Для отслеживания каждой поездки в 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 предоставляет детали поездки и местоположение транспортного средства в потребительский SDK, который использует слушатель для получения обновлений о поездке и их отображения в потребительском приложении. Fleet Engine автоматически обновляет расчетное время прибытия, оставшееся расстояние, маршруты и оставшиеся путевые точки транспортного средства. Дополнительную информацию см. в разделе «Совместное использование поездок по запросу» . |
| 5 | Поездка завершена. | Как только транспортное средство достигнет конечной точки маршрута и водитель подтвердит успешное завершение поездки, ваша система установит TripStatus в Fleet Engine на COMPLETE . Обратите внимание, что, как и транспортные средства, объекты поездок остаются активными в Fleet Engine в течение 7 дней независимо от статуса, после чего они удаляются. |
Последовательность действий при поездке
На следующей диаграмме представлено более подробное изображение этого процесса.
