Fleet Engine 提供了 SearchTripsRequest
端点,您可以使用该端点查找行程。本文档介绍了您可能需要使用此功能的两种场景。
如需使用 gRPC,请参阅 SearchTripsRequest
;如需使用 REST,请参阅 trips.Search
。
确定车辆的有效行程
如需查找特定字段的有效行程,请使用 SearchTripsRequest
消息将 vehicle_id
设置为要考虑的车辆,并将 active_trips_only
设置为 true
。
在您的系统和车队引擎之间对车辆空闲情况进行对账
在某些情况下,您可能会看到 SearchVehicles
返回的结果与您知道在系统和车队中可用的车辆不符。之所以会出现这种情况,是因为 SearchVehicles
不会显示正在进行行程的车辆,或者会将其在结果排名中向下推。造成这种情况的一个原因是,车辆已完成行程,但行程状态未正确设置为 COMPLETE
或 CANCELED
。通过使用 SearchTrips
查找未完成的行程,您可以评估车辆,确保您系统中的 TripStatus
与 Fleet Engine 中的 TripStatus
一致。
如需以这种方式使用 SearchTrips
,请在 SearchTripsRequest
消息中设置以下内容:
vehicle_id
应为空。active_trips_only
应为true
。minimum_staleness
应大于大多数行程时长;例如,1 小时。
此类请求的结果包括既不是 COMPLETE
也不是 CANCELED
且已超过一小时未更新的行程。然后,您可以检查这些行程,确保其在车队引擎中的状态已正确更新。