¶ Uber Direct とは？

Uber Direct は、販売業者がオンデマンド（ASAP、すぐに配達）と予約配達のサービスを提供できるようサポートします。これを実現するため、Uber は効果的な配達管理をサポートし、販売業者が自社固有の要件に合わせて配達オプションをカスタマイズできるようにするさまざまな機能を活用しています。Uber Direct を活用すると、Uber の配達パートナーをピックアップと配達に割り当てるプロセスを簡単に自動化できます。

¶ レート制限はありますか？

レート制限はエンドポイントによって異なります。特定の期間に許可されたリクエストの数を超過した場合は、429 customer_limited の応答が返されます。意図した利用シナリオによってレート制限が適用された場合は、アカウントマネージャーにサポートを依頼することをお勧めします。

¶ 「注文者 ID」、「クライアント ID」、「クライアントシークレット」の違いは何ですか？

「クライアント ID」と「クライアントシークレット」はアカウント全体で一貫しており、すべての組織、注文者 ID、場所に適用されます。ただし、API で使用される注文者 ID は、設定された組織体制によって異なる点に留意してください。運用フェーズに入る前に、アカウントマネージャーか Uber Direct の担当窓口と十分に議論して最終決定することが必要です。

¶ 生成された見積もりと quote_id はどのくらいの時間有効ですか？

15 分間です。

¶ 配達ステータスの Webhook と配達パートナーの最新情報に関する Webhook の違いは何ですか？

• 配達ステータスの Webhook：courier_imminent の変更など、配達の特定の段階でトリガーされる静的 Webhook です。詳細については「配達ステータスの Webhook」を参照してください。

• 配達パートナーの最新情報に関する Webhook：20 秒ごとに実行される動的 Webhook で、配達パートナーの位置情報に関する最新の座標を提供します。詳細については「配達パートナーの最新情報に関する Webhook」を参照してください。

どちらの Webhook についても、courier_imminent = true は配達パートナーがピックアップまたは受け渡しの場所から約 80 メートル以内にいることを示しています。

¶ 住所に関するベストプラクティスは何ですか？

• 構造化された住所と構造化されていない住所
  Uber のプラットフォームでは、構造化された住所と構造化されていない住所の 2 種類の形式に対応しています。どちらの形式も利用できますが、配達プロセスにおける正確性と妥当性を向上するためにも、構造化された住所形式を活用することを強くお勧めします。

  構造化された住所：

  {
    "dropoff_address": "{\"street_address\":[\"1515 3rd St\",\"Apt. 5\"],\"city\":\"San Francisco\",\"state\":\"CA\",\"zip_code\":\"94158\",\"country\":\"US\"}"
  }
  

  構造化されていない住所：

  {
    "dropoff_address": "1515 3rd St, San Francisco, CA 94158"
  }
  

• 緯度と経度
  Uber に対するすべてのリクエストには、有効で正確な経度と緯度を含めることをお勧めします。
  重要：デフォルトでは、提供された緯度および経度が住所から 1 キロ以上離れている場合は、バックエンドのジオコーディングから返されたデータで上書きします。

• 住所形式の一貫性に関する推奨事項
  連携をスムーズに行うため、Quote と Create Delivery リクエストのどちらにおいても、同じ住所形式（構造化と非構造化のいずれか）を使用して受け渡し住所を送信してください。使用する形式が異なるとジオコーディングの結果が変わり、システム内で「delivery location changed（配達場所が変更されました）」というエラーが生じる可能性があります。

  例：

  不適切

    - Quote Request: "dropoff_address": "190 Mathilda Pl, Sunnyvale, CA 94086"
    - Create Delivery Request: "dropoff_address": "{\"street_address\":[\"190 Mathilda Pl\",\"\"],\"city\":\"Sunnyvale\",\"state\":\"CA\",\"zip_code\":\"94086\"}"
  

  適切：構造化された住所

    - Quote Request: "dropoff_address": "{\"street_address\":[\"190 Mathilda Pl\",\"\"],\"city\":\"Sunnyvale\",\"state\":\"CA\",\"zip_code\":\"94086\"}"
    - Create Delivery Request: "dropoff_address": "{\"street_address\":[\"190 Mathilda Pl\",\"\"],\"city\":\"Sunnyvale\",\"state\":\"CA\",\"zip_code\":\"94086\"}"
  

  適切：構造化されていない住所

    - Quote Request: "dropoff_address": "190 Mathilda Pl, Sunnyvale, CA 94086"
    - Create Delivery Request: "dropoff_address": "190 Mathilda Pl, Sunnyvale, CA 94086"
  

¶ Update Delivery API を使用して更新できるのはどのフィールドですか？

以下のテーブルを参照してください。