查找行程

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

如需使用 gRPC,请参阅 SearchTripsRequest;如需使用 REST,请参阅 trips.Search

确定车辆的有效行程

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

在您的系统和车队引擎之间对车辆空闲情况进行对账

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

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

  • vehicle_id 应为空。
  • active_trips_only 应为 true
  • minimum_staleness 应大于大多数行程时长;例如,1 小时。

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

后续步骤