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

В документации в этом разделе показано, как создавать поездки и работать с ними с помощью службы поездок по требованию 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 значение COMPLETE в Fleet Engine. Имейте в виду, что, как и транспортные средства, объекты поездки остаются активными в Fleet Engine в течение 7 дней независимо от статуса, после чего они удаляются.

Последовательность действий при отключении

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

ПоездкаПоследовательностьДиаграмма

Что дальше

,

В документации в этом разделе показано, как создавать поездки и работать с ними с помощью службы поездок по требованию 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 значение COMPLETE в Fleet Engine. Имейте в виду, что, как и транспортные средства, объекты поездки остаются активными в Fleet Engine в течение 7 дней независимо от статуса, после чего они удаляются.

Последовательность действий при отключении

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

ПоездкаПоследовательностьДиаграмма

Что дальше