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

このセクションのドキュメントでは、 Google Maps Mobility のオンデマンド移動サービスこのモジュールは、 次のとおりです。

  • Fleet Engine: Fleet Engine の実装に精通している必要があります。 リクエストのメカニズム、セキュリティなどです。詳しくは、フリートとは Engine Service? および Fleet Engine の設定のセキュリティ トピックをご覧ください。
  • オンデマンド サービス用の車両の基本。詳しくは、 自動車の概要
  • オンデマンド サービス向けのルートの基本情報オンデマンドの旅程をご覧ください。

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

オンデマンド サービス用の Fleet Engine において、旅行とは 顧客からのフード デリバリーや配車リクエストへの対応。ルート フローの進展に応じて、Fleet Engine に報告するステータスがあります。 NEWENROUTE_TO_PICKUP など。ルートステータスは、位置情報 車両に割り当てられたウェイポイントにより、Fleet Engine はそれらの車両を ルートの更新情報が付加されます[フリート] でオンデマンドの旅程を参照 Engine の基礎」をご覧ください。

ルートのライフサイクル

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

次の表に、 システムとそのライフサイクル ステージを Fleet Engine で管理できます。前提条件として、 Fleet Engine、ルートに割り当てる車両を用意して、位置情報を更新 有効にする必要があります。Driver SDK: オンデマンドの賃走をご覧ください。

1 予約リクエストを受信します。 Fleet Engine による旅行が始まる前に、予約システムは 配車サービスまたは宅配のリクエストを 予約システム。すると、システムでルートエンティティが作成され、 CreateTrip は、乗車場所などの必須フィールドに置き換えます。 この時点で他のフィールド(乗客、予約など)も または、車両が割り当てられるまで待ちます。詳しくは、 目的地を 1 つだけにするルートを作成します
2 車両の割り当て。

車両をシステム内で直接ルートに割り当てるか Fleet Engine に割り当てを報告することも、 車両検索 ルートと車両の両方でフィルタして車両を検索するサービス の各属性を使用して、その行程全体に最適な車両を見つけます。オンライン 検索半径内の車両から、その近接性が Driver SDK によって提供される位置情報の更新データなどです。

SearchVehicle がルートに一致する車両を返すと、 システムは UpdateTrip エンドポイントを呼び出して車両 ID を報告します あなたが NEW 件のルートに割り当てました。

3 ルートを更新します。 ドライバーがルートを承認し、 乗車場所を指定すると、ルートの状況が NEW から更新されます 宛先: ENROUTE_TO_PICKUP引き続き車両をポーリングします カスタマー ジャーニー全体を通じて または Fleet Engine にポーリングすることで、Fleet Engine に Driver SDK から送信される車両位置情報の継続的ストリーム。お客様の システムは各ジャーニーのマイルストーンを Fleet Engine に報告し、Fleet Engine は それに応じて車両のウェイポイント リストが調整されます。
4 カスタマー ジャーニーを消費者と共有する。 Fleet Engine を使用すると、ルートの詳細と車両の位置情報を Consumer SDK(リスナーを使用してルート更新情報を受信し、表示する) 確認できます。Fleet Engine は到着予定時刻を自動更新し、 距離、ルート、残りの車両の地点詳しくは、 詳しくは、オンデマンドの賃走の経路を共有するをご覧ください。
5 移動を完了。 車両がルートの目的地の地点に到着し、 ルートが成功を示すと、システムは Fleet Engine で TripStatusCOMPLETE。保存 車両と同様に、Fleet Engine 内でルートエンティティはアクティブのままになります。 ステータスを問わず、最大 7 日間削除され、その時点で削除されます。

ルートシーケンス フロー

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

TripSequenceDiagram

次のステップ