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 一致。
如要以這種方式使用 SearchTrips
,請在 SearchTripsRequest
訊息中設定下列項目:
vehicle_id
應為空白。active_trips_only
應為true
。minimum_staleness
應為大於大多數行程時間的時間,例如一小時。
這類要求的結果包含既非 COMPLETE
也非 CANCELED
,且超過一小時未更新的行程。接著,您可以檢查這些行程,確保其在 Fleet Engine 中的狀態已正確更新。