オンデマンドルートとは何ですか？

このセクションのドキュメントでは、Google Maps Mobility のオンデマンド乗車サービスを使用して乗車を作成し、操作する方法について説明します。次の内容を理解していることを前提としています。

  • Fleet Engine: Fleet Engine の実装の詳細、リクエスト メカニズム、セキュリティについて理解している必要があります。詳細については、Fleet Engine サービスとはと、Fleet Engine を設定するのセキュリティに関するトピックをご覧ください。
  • オンデマンド サービスの車両の基本。車両の概要をご覧ください。
  • オンデマンド サービスの乗車に関する基本情報。オンデマンドの乗車をご覧ください。

使用する TripService は、gRPC と REST で使用できます。わかりやすくするために、フィールド参照は gRPC 規約に従います。

オンデマンド サービスの Fleet Engine では、乗車は、ユーザーからのフード デリバリーや乗車リクエストの履行をモデル化する一種の移動です。乗車には、NEW、ENROUTE_TO_PICKUP など、移動の進行に合わせて Fleet Engine に報告するステータスがあります。乗車ステータスは、車両に割り当てられた位置情報付きの経由地に対応しています。Fleet Engine は、ユーザーが乗車を更新するたびに、これらの車両の経由地を変更します。車両と乗車との関係について詳しくは、Fleet Engine の基本のオンデマンド乗車をご覧ください。

旅行のライフサイクル

Fleet Engine で各乗車を追跡するには、まず Trip エンティティを作成する必要があります。参考までに、gRPC または REST をご覧ください。

次の表に、システムで作成された乗車と Fleet Engine でのライフサイクル ステージの例を示します。このガイドでは、Fleet Engine を設定済みで、ドライバー アプリで位置情報の更新が有効になっている移動に割り当てる車両があることを前提としています。Driver SDK: オンデマンドの移動をご覧ください。

1 予約リクエストを受け取ります。 Fleet Engine の乗車が開始される前に、まず予約システムがアプリまたは他の予約システムを通じて、利用者から乗車または配達のリクエストを受け取ります。システムは、乗車場所などの必須フィールドを含む CreateTrip を使用して、乗車エンティティを作成します。この時点で、乗客や降車場所などの他のフィールドを設定することも、車両が割り当てられるまで待つこともできます。1 つの目的地への旅行を作成するをご覧ください。
2 車両を割り当てます。

システム内で車両を乗車に直接割り当てて Fleet Engine に割り当てを報告するか、車両の検索サービスを使用して車両を検索し、乗車と車両の両方の属性でフィルタして、乗車を完了する最適な車両を見つけることができます。検索範囲内のオンライン車両は、Driver SDK から提供される位置情報の更新を通じて、その近接性を知らせます。

SearchVehicle が乗車と一致する車両を返すと、システムは UpdateTrip エンドポイントを呼び出して、NEW 乗車に割り当てた車両 ID を報告します。
3 ルートを更新します。 ドライバーが乗車を承諾し、お迎え場所へのナビゲーションを開始すると、システムは乗車のステータスを NEW から ENROUTE_TO_PICKUP に更新します。アプリからバックエンドへの直接接続、または Driver SDK から車両の位置情報の継続的なストリームを受信する Fleet Engine のポーリングのいずれかを通じて、乗車中も車両の位置情報のポーリングを継続します。システムは各乗車マイルストーンを Fleet Engine に報告し、Fleet Engine はそれに応じて車両のウェイポイント リストを更新します。
4 カスタマー ジャーニーをユーザーと共有します。 Fleet Engine は、乗車に関する詳細情報と車両の位置情報を Consumer SDK で利用できるようにします。Consumer SDK はリスナーを使用して乗車に関する最新情報を受け取り、ユーザー向けアプリに表示します。Fleet Engine は、到着予定時刻、残り距離、ルート、車両の残りの経由地を自動的に更新します。詳しくは、オンデマンド乗車で乗車経路を共有するをご覧ください。
5 旅行を完了します。 車両が乗車地の経由地に到着し、ドライバーが乗車が完了したことを示すと、Fleet Engine で TripStatus が COMPLETE に設定されます。車両と同様に、乗車エンティティはステータスに関係なく Fleet Engine 内で 7 日間アクティブな状態が続き、その後削除されます。

乗車シーケンス フロー

次の図は、このフローの詳細を示しています。

TripSequenceDiagram

次のステップ