Fleet Engine предоставляет конечную точку SearchTripsRequest, которую можно использовать для поиска поездок. В этом документе описаны два сценария, в которых может пригодиться эта функция.
Подробнее о SearchTripsRequest для gRPC и trips.Search для REST…
Как определить активные поездки для транспортного средства
Чтобы найти активные поездки для определенных полей, используйте сообщение SearchTripsRequest, чтобы задать для поля vehicle_id рассматриваемый автомобиль, а для поля active_trips_only – значение true.
Как согласовать данные о наличии автомобилей в вашей системе и Fleet Engine
В некоторых случаях результаты, возвращаемые SearchVehicles, могут не соответствовать транспортным средствам, которые, как вы знаете, доступны в вашей системе и автопарке. Это происходит потому, что SearchVehicles не показывает автомобили с активными поездками или опускает их в результатах поиска. Одна из причин – транспортные средства завершили поездки, но статус поездки не был правильно установлен на COMPLETE или CANCELED. Используя SearchTrips для поиска открытых поездок, вы можете проверять транспортные средства, чтобы убедиться, что TripStatus в вашей системе соответствует данным Fleet Engine.
Чтобы использовать SearchTrips таким образом, задайте в сообщении SearchTripsRequest следующие параметры:
- Поле
vehicle_idдолжно быть пустым. active_trips_onlyдолжно бытьtrue.minimum_stalenessдолжно быть больше, чем продолжительность большинства поездок, например один час.
Результаты такого запроса включают рейсы, которые не являются ни COMPLETE, ни CANCELED и не обновлялись более часа. Затем вы можете проверить, правильно ли обновляется статус поездок в Fleet Engine.