旅行を検索する

フリートエンジンは、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 のステータスが適切に更新されていることを確認できます。

次のステップ