查找行程

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 应大于大多数行程时长，例如 1 小时。

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

后续步骤