旅行を検索する

Fleet Engine には、ルートの検索に使用できる SearchTripsRequest エンドポイントが用意されています。このドキュメントでは、この機能を使用する可能性のある 2 つのシナリオについて説明します。

gRPC の場合は SearchTripsRequest、REST の場合は trips.Search をご覧ください。

車両のアクティブなルートを特定する

特定のフィールドのアクティブなルートを検索するには、SearchTripsRequest メッセージを使用して、vehicle_id を対象の車両に設定し、active_trips_only を true に設定します。

システムと Fleet Engine の間で車両の空き状況を調整する

状況によっては、SearchVehicles から返された結果が、システムとフリートで空きがあると認識されている車両と一致しないことがあります。これは、SearchVehicles がアクティブなルートを持つ車両を表示しないか、結果のランキングで下位に表示するためです。この原因の 1 つは、車両がルートを完了したものの、ルートのステータスが COMPLETE または CANCELED に正しく設定されていないことです。SearchTrips を使用して未完了のルートを検索することで、車両を評価して、システムの TripStatus が Fleet Engine のステータスと一致していることを確認できます。

このように SearchTrips を使用するには、SearchTripsRequest メッセージで次の値を設定します。

  • vehicle_id は空にする必要があります。
  • active_trips_only は true にする必要があります。
  • minimum_staleness は、ほとんどのルートの所要時間よりも長い時間にする必要があります（たとえば 1 時間）。

このようなリクエストの結果には、COMPLETE でも CANCELED でもなく、1 時間以上更新されていないルートが含まれます。これらのルートを調べて、Fleet Engine でのステータスが正しく更新されていることを確認できます。

次のステップ