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

欧州経済領域（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 のドキュメントへのリンクについては、参考情報セクションをご覧ください。

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

配車サービスまたは配達のユースケース図
ライドシェアまたは配達のユースケースの図

ライドシェアの例

ライドシェアのシナリオを考えてみましょう。このシナリオでは、消費者が乗車を予約するためのアプリと、ドライバーが乗車の通知と目的地へのルート情報を受け取るためのアプリがあります。

この画像は、ナビゲーション ポイントが選択されている消費者向けライドシェア アプリと、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 を使用するモバイル ドライバーアプリに渡され、ドライバーを正しい乗車場所に案内するウェイポイントが作成されます。

関連情報