このセクションのドキュメントでは、Google マップ モビリティのスケジュール設定タスク サービスを使用して、スケジュール設定されたタスクを作成して操作する方法について説明します。以下の内容を理解していることを前提としています。
- Fleet Engine: Fleet Engine の実装の詳細、リクエスト メカニズム、セキュリティに精通している必要があります。詳細については、Fleet Engine サービスとはをご覧ください。また、Fleet Engine の設定のセキュリティ トピックをご覧ください。
- オンデマンド サービス向けの乗り物の基本。車両の概要をご覧ください。
- スケジュール設定されたタスク サービスのタスクの基本スケジュールされたタスクをご覧ください。
使用する Task リソースは、gRPC と REST の両方で使用できます。
スケジュールされたタスクの Fleet Engine において、タスクは、ユーザーに対するスケジュールされた出荷またはサービスを実行するドライバーのアクティビティを表します。タスクを完了する必要がある車両停車場所にタスクを割り当てると、車両はそれらの停車地まで走行します。
タスクの状態には OPEN と CLOSED の 2 つがあります。これらの状態は、システム内でタスクがアクティブかどうかを示します。アクティブなタスクに向けて行程が進むと、タスクに関連付けられている車両の停車場所（ENROUTE または ARRIVED）を更新して、このことを Fleet Engine に報告します。ドライバーがタスクを完了して停車地を出発したら、車両の停車地のリストから該当する停車場所を削除します。タスクと、タスクと停車地や車両との関係については、Fleet Engine の基本のスケジュールされたタスクをご覧ください。
タスクのライフサイクル
Fleet Engine で各タスクを追跡するには、まず Task エンティティを作成する必要があります。詳しくは、gRCP または REST をご覧ください。
次の表に、システムで作成されたタスクのエンドツーエンドのフローと、Fleet Engine でのそのライフサイクル ステージの例を示します。Fleet Engine が設定され、タスク用の車両があり、ドライバー アプリで位置情報の更新が有効になっていることを前提としています。Driver SDK: スケジュール設定されたタスクをご覧ください。
| 1 | タスクを作成する。 | まず、作業サイクルの開始時に、コーディネーターまたはサービス管理者がデリバリーのタスクまたはサービス用のマニフェストを作成します。次に、タスクのタイプや場所などの必須フィールドを含む CreateTrip を使用して、タスク エンティティを作成します。また、この時点で他の設定（目標時間枠、ジャーニー共有の可視性、カスタム属性など）を指定することもできます。配送タスクを作成すると関連ガイドをご覧ください。 |
| 2 | タスクのスケジュール設定。 | 配達タスクのスケジュールを設定するときに、配達車両の更新リクエストを発行します。このリクエストは車両エンティティを更新し、移動する停車地のリストを反映します。各停車地に、その停車地で完了するタスクのリストを割り当てます。配達車両のタスクを更新するをご覧ください。 |
| 3 | タスクの進行状況を更新します。 | タスクが配送停車地に割り当てられ、Fleet Engine でアクティブになると、車両が停車地に接近して到着し、それを完了する際の車両の進行状況がシステムから Fleet Engine に通知されます。この情報により、Fleet Engine は車両の移動中と 1 日を通して、ルート選択とステータス更新を最適に実行できるようになります。車両停止ステータスを更新するをご覧ください。 |
| 4 | ジャーニーを共有する。 | 配達日に車両がアクティブ ナビゲーションを開始すると同時に、関心のある関係者と乗車情報を共有できます。Fleet Engine は、タスクの詳細と車両の位置情報を、関係者が次の方法で利用できるようにします。
|
| 5 | タスクを完了します。 | 次の方法で Fleet Engine の配送タスクを完了します。
|
タスク シーケンス フロー
次の図は、タスクのライフサイクルの詳細なフローを示しています。
