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

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

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

ナビゲーション ポイント トークンを作成して渡すには、Geocoding API の Destinations メソッドを使用して、ユーザーがナビゲーション ポイントのリストから優先する場所を選択できるようにします。ユーザーの選択は、Geocoding API の Destinations メソッドから返されるナビゲーション ポイントになります。

次に、目的地座標とコンテキスト情報を含むナビゲーション ポイント トークンを Navigation SDK for Android、Navigation SDK for iOS、または Routes API に渡します。これにより、正確なルート設定のための経由地が作成されます。Navigation SDK は、トークンが関連付けられている場所に基づいて、ドライバーの目的地をハイライト表示します。

例: 相乗りユースケース

概要

この例では、Geocoding API、Routes API、Navigation SDK for iOS または Android を組み合わせて、ルートの料金を計算し、ドライバーを正しい乗車地点に誘導するライドシェア アプリを作成する方法を示します。

大まかな手順は次のとおりです。

  1. Geocoding API を介してナビゲーション ポイント トークンを取得します。
  2. Routes API を使用してルートを計算し、ルートトークンにエンコードします。
  3. ナビゲーション ポイント トークンとルート トークンの両方を Navigation SDK に渡します。
  4. Navigation SDK を使用して、ドライバーを正しい乗車地点に誘導します。

関連する Routes API、Navigation SDK for iOS、Navigation SDK for Android のドキュメントへのリンクについては、関連資料のセクションをご覧ください。

この図は、ライドシェア アプリや配達アプリが、ジオコーディング API、Routes API、Navigation SDK for iOS または Android を使用して、ルートトークンとナビゲーション ポイント トークンを使用してドライバーをルート設定する方法を示しています。

ライドシェアまたは配達のユースケース図
ライドシェアリングまたは配達のユースケースの図

ライドシェアの例

乗客が乗車を予約するためのアプリと、ドライバーが乗車と目的地までの経路情報の通知を受け取るためのアプリという 2 つのアプリがあるライドシェアのシナリオを考えてみましょう。

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

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

ユーザーがユーザー アプリを開くと、アプリは Geocoding 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
      }
    }
]

アプリのバックエンドは、ナビゲーション ポイント トークンを Routes API に提供して、ルートを計算し、ルートトークンを取得します。

最後に、ナビゲーション ポイント トークンとルートトークンの両方が、Navigation SDK for iOS または Android を使用するモバイル ドライバー アプリに渡され、ドライバーを正しい乗車地点に誘導するための経由地が作成されます。

関連情報