スケジュールされたタスクとは

このセクションのドキュメントでは、Google マップ モビリティのスケジュール設定されたタスク サービスを使用して、スケジュール設定されたタスクを作成して操作する方法について説明します。次の内容を理解していることを前提としています。

使用する 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 に通知されます。この情報により、フリート エンジンは、ルーティングとステータスの更新を、ルート上だけでなく、車両の 1 日を通して最適に実行できます。車両の停車ステータスを更新するをご覧ください。
4 ルートを共有する。 配達当日に車両がナビゲーションを開始すると同時に、関係するステークホルダーとルート情報を共有できます。Fleet Engine では、関心のあるステークホルダーがタスクの詳細と車両の位置情報の両方を以下の方法で利用できます。
  • 購入者向けの配送情報。このソリューションを使用すると、消費者は、指定した車両の位置情報とともに荷物のステータスを確認できます。
    スケジュールされたタスクの消費者共有をご覧ください。
  • 管理者向けのフリート ステータス情報。このソリューションにより、フリート管理者はフリート内の配送車両の位置と停留所をニア リアルタイムで可視化できます。車両のルートがわかっている場合、地図ビュー コンポーネントは、予測されたパスに沿って移動する車両をアニメーション化します。
    JavaScript フリート トラッキング ライブラリをご覧ください。
5 タスクを確定します。 Fleet Engine で配送タスクを確定するには、次の方法を使用します。
  • タスクを閉じる: 配送タスクを閉じると、そのタスクはアクティブでなくなります。
  • タスクの結果を設定する: タスクがクローズされたら、タスクが成功したか失敗したかを示すことで、配信が行われたか否かを指定します。これは、コンシューマー エクスペリエンスで配達結果を表示し、Fleet Engine サービスの正しい課金を保証するために、タスクを完了するうえで重要な部分です。
配送車両と同様に、タスク エンティティはステータスに関係なく Fleet Engine 内で 7 日間アクティブなままになり、その後削除されます。タスクをファイナライズするをご覧ください。

タスク シーケンス フロー

次の図は、タスクのライフサイクルの詳細なフローを示しています。

TaskSequenceDiagram

次のステップ