このセクションのドキュメントでは、Google マップ モビリティのスケジュール設定されたタスク サービスを使用して、スケジュール設定されたタスクを作成して操作する方法について説明します。以下の説明を理解していることを前提としています。
- Fleet Engine: Fleet Engine の実装の詳細、リクエスト メカニズム、セキュリティに精通している必要があります。Fleet Engine サービスとはと Fleet Engine を設定するのセキュリティ トピックをご覧ください。
- オンデマンド サービス用の車両の基本。車両の概要をご覧ください。
- スケジュール設定されたタスクサービスのタスクの基本。スケジュール設定されたタスクをご覧ください。
使用する Task リソースは、gRPC と REST の両方で使用できます。
スケジュール設定されたタスクの Fleet Engine では、タスクは、消費者のスケジュール設定された配送またはサービスを実行するドライバー アクティビティを表します。タスクを完了する必要がある車両の停車地にタスクを割り当てると、車両はその停車地まで走行します。
タスクの状態は、OPEN または CLOSED のいずれかです。これらの状態は、システム内でタスクがアクティブかどうかを示します。アクティブなタスクに向けてジャーニーが進展したら、そのタスクに関連付けられている停車地（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 では、次の方法で発送タスクを完了します。
|
タスク シーケンス フロー
次の図は、タスクのライフサイクルの詳細なフローを示しています。
