Google Maps Platform のラスト ワンマイル フリート ソリューション(LMFS)では、配送に関連するタスクが正常に完了すると請求対象取引が発生します。
Task オブジェクトは基本的なオブジェクト タイプで、LMFS Deliveries API で請求対象トランザクションのトラッキングと報告を行ううえで重要な役割を果たします。この規約では、ドライバのタスクを正しくモデル化し、TaskOutcome
を適切に記録することが求められています。これにより、請求対象のトランザクションがすべて正しく記録されます。契約を結んでいるお客様については、サービスに適用される次のレポート要件をご覧ください。
課金対象タスクとは
請求対象のタスクとは、配送(一意の配送業者から一意の受取人に 1 つ以上の商品を輸送する)を正常に完了したタスクを指します。配送の失敗タスクは請求対象外です。
次の表に、課金対象のタスクと課金対象外のタスクの実際のシナリオを示します。
シナリオ | 請求可能かどうか |
---|---|
ドライバーが荷物を配達しようとしましたが、成功しました。たとえば、受取人が荷物を直接受け取った、ドライバーが近所の人に荷物を置いてきた、などです。 | はい |
ドライバーが、その荷物に記載されている予定時間外に荷物を配達した。 | はい |
ドライバーは配送が完了したと報告したが、受取人が後で荷物の受け取りに異議を申し立てた。 | はい |
ドライバーが荷物を配達しようとしましたが、配達できませんでした。たとえば、署名が必要な署名のために受信者が自宅にいなかった、または住所が間違っていた、などです。 | いいえ |
ドライバーが規定の休憩を取る、または停車する。 | いいえ |
Deliveries API 内での請求はどのように行われますか?
タスクは、次の条件で課金されます。
タスクの型は
delivery
に設定されています。集荷タスクは課金をトリガーせず、スケジュールされた休憩や停車は対象外です。すべての課金対象トランザクションには配信タスクが関連付けられている必要があります。デポに配送されるファースト ワンマイルの集荷では、受け取り場所でのピックアップ タスクとデポでの配達タスクのモデル化が可能です。TaskOutcome
の値はSUCCEEDED
です。
Last Mile Fleet Solution Deliveries API は、値が SUCCEEDED
の TaskOutcome
が初めて更新されたときに、課金対象イベントを作成します。この場合、その SKU の請求指標が増加します。そのタスクに対する後続の更新は、この課金指標には影響しません。この課金指標は、最初に結果が設定された後に増減することはできません。
タスクをどのようにモデル化すればよいでしょうか。
このセクションでは、利用規約に基づいてタスクが正しく設定されていることを確認するための基本的な推奨事項について説明します。
- 配送タスクの適切な項目を設定します。タスクタイプを
delivery
に設定し、一意のタスク ID を割り当て、各タスクを完了する正しい場所を指定します。すべての配送に配達タスクが指定されていることを確認します。 - 配送業者と受取人の組み合わせごとに別々のタスクを作成します。たとえば、複数の配送業者の 1 人の受取人に対して 2 つのタスクを使用します。または、複数の荷物が複数の受信者に配信される 1 つの配送先の場合は、複数のタスクを作成します。
- 配送以外のタスクを正しく定義します。停留所・時刻表の場合は、タスク
Type
をSCHEDULED_STOP
に設定します。ドライバー休憩の場合は、Type
をUNAVAILABLE
に設定します。 TaskOutcome
フィールドを適切に設定する。タスクが完了したら、実装でTaskOutcome
がSUCCEEDED
またはFAILED
に設定されていることを確認します。完了したタスクをCLOSED
状態に更新するだけでは、利用規約への準拠にはなりません。タスクの結果は、Driver SDK、gRPC、または REST を使用して設定できます。
詳細については、次の Fleet Engine ユーザーガイドのトピックをご覧ください。