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 の TripStatus と一致していることを確認できます。
このように SearchTrips を使用するには、SearchTripsRequest メッセージで次のように設定します。
vehicle_idは空にする必要があります。active_trips_onlyはtrueにする必要があります。minimum_stalenessは、ほとんどのルートの所要時間よりも長い時間（1 時間など）にする必要があります。
このようなリクエストの結果には、COMPLETE でも CANCELED でもない、1 時間以上更新されていないルートが表示されます。これらのルートを調べて、Fleet Engine のステータスが適切に更新されていることを確認できます。