ナビゲーション ポイント トークンを使用したルート

欧州経済領域（EEA）のデベロッパー

ナビゲーション ポイント トークンを使用すると、目的地に関する重要なコンテキスト情報を Navigation SDK for Android または Navigation SDK for iOS に送信して、ルート設定とドライバー エクスペリエンスを改善できます。これは、ユーザーの入力なしでは受け取り場所や降車場所が不明確になる可能性がある、フード デリバリーやライドシェアなどのケースで役立ちます。

この画像は、ナビゲーション ポイントが選択されている一般ユーザー向けのライドシェア アプリの例と、Navigation SDK for Android を使用してドライバーを正確にルート案内するドライバー アプリの例を示しています。

消費者向けアプリとドライバー向けアプリの例

ナビゲーション ポイント トークンを作成して渡すには、ジオコーディング API の Destinations エンドポイントを使用して、ユーザーがナビゲーション ポイントのリストから優先する場所を選択できるようにします。ユーザーの選択は、Geocoding API の Destinations エンドポイントから返されるナビゲーション ポイントになります。次に、目的地座標とコンテキスト情報を含むナビゲーション ポイント トークンを Navigation SDK for Android または Navigation SDK for iOS に渡します。ここで、正確なルート設定のための経由地が作成されます。Navigation SDK は、トークンが関連付けられているプレイスに基づいて、ドライバー向けに目的地をハイライト表示します。

ナビゲーション ポイント トークンが作成され、ルーティングのために Nav SDK に送信される仕組み

たとえば、ライドシェアのユースケースを考えてみましょう。この場合、乗客が乗車を予約するためのアプリと、ドライバーが乗車と目的地までのルート情報の通知を受け取るためのアプリの 2 つがあります。

ユーザーがユーザー アプリを開くと、アプリはジオコーディング API の Destinations エンドポイントを呼び出し、ユーザーにナビゲーション ポイントの候補を提示します。

消費者が配送先を選択している

ユーザーは、SearchDestinations リクエストのレスポンス本文にある navigationPoints の配列から、希望するポイントを選択します。

"navigationPoints": [
    {
      "navigationPointToken": <encoded navigation point token>,
      "displayName": "South Entrance",
      "travelModes": ["DRIVE"],
      "usages": ["PICKUP","DROPOFF"],
      "location": {
        "lat": 37.3940894,
        "lng": -122.0788389
      }
    }
]

レスポンスから取得したナビゲーション ポイント トークンは、Android または iOS 向け Navigation SDK を使用するモバイル ドライバ アプリに渡され、ドライバを正しい乗車地点に誘導するための経由地が作成されます。