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