ナビゲーション ポイント トークンを使用すると、目的地に関する重要なコンテキスト情報を Android 用 Navigation SDK に送信して、ルート選択とドライバー エクスペリエンスを改善できます。これは、ユーザーの入力なしでは受け取り場所や降車場所が不明確になる可能性がある、フード デリバリーやライドシェアなどの場合に便利です。
この画像は、ナビゲーション ポイントが選択されている一般ユーザー向けのライドシェア アプリの例と、Navigation SDK for Android を使用してドライバーを正確にルート案内するドライバー アプリの例を示しています。
ナビゲーション ポイント トークンを作成して渡すには、ジオコーディング API の Destinations エンドポイントを使用して、ユーザーがナビゲーション ポイントのリストから優先する場所を選択できるようにします。ユーザーの選択は、Geocoding API の Destinations エンドポイントから返されるナビゲーション ポイントになります。次に、デスティネーションの座標とコンテキスト情報を含むナビゲーション ポイント トークンを Navigation SDK for Android に渡します。ここで、正確なルート設定のための経由地が作成されます。Navigation SDK は、トークンが関連付けられているプレイスに基づいて、ドライバー向けに目的地をハイライト表示します。
たとえば、ライドシェアのユースケースを考えてみましょう。この場合、消費者が乗車を予約するためのアプリと、ドライバーが乗車と目的地までのルート情報の通知を受け取るためのアプリの 2 つがあります。
ユーザーがユーザー アプリを開くと、アプリは 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 } } } ]
レスポンスから取得したナビゲーション ポイント トークンは、Navigation SDK for Android を使用して Waypoint を作成し、ドライバーを正しい乗車地点に誘導するモバイル ドライバー アプリに渡されます。