查找行程

Fleet Engine 提供 SearchTripsRequest 端点，您可以使用该端点查找行程。本文档介绍了您可能需要使用此功能的两种场景。

如需使用 gRPC，请参阅 SearchTripsRequest；如需使用 REST，请参阅 trips.Search。

确定车辆的有效行程

如需查找特定字段的有效行程，请使用 SearchTripsRequest 消息将 vehicle_id 设置为要考虑的车辆，并将 active_trips_only 设置为 true。

对照您的系统和 Fleet Engine 中的车辆空闲情况

在某些情况下，您可能会看到 SearchVehicles 返回的结果与您知道在系统和车队中可用的车辆不符。这是因为 SearchVehicles 不会显示正在执行行程的车辆，或者会将其在结果排名中向下推。造成这种情况的一个原因是，车辆已完成行程，但行程状态未正确设置为 COMPLETE 或 CANCELED。通过使用 SearchTrips 查找未完成的行程，您可以评估车辆，确保您系统中的 TripStatus 与车队引擎中的 TripStatus 一致。

如需以这种方式使用 SearchTrips，请在 SearchTripsRequest 消息中设置以下内容：

  • vehicle_id 应为空。
  • active_trips_only 应为 true。
  • minimum_staleness 应为大于大多数行程时长的时长；例如，一小时。

此类请求的结果包括既不是 COMPLETE 也不是 CANCELED 且已超过一小时未更新的行程。然后，您可以检查这些行程，确保其在车队引擎中的状态已正确更新。

后续步骤