ナビゲーション ポイントへのルート

Android 向け Navigation SDK では、ウェイポイント（ナビゲーション ポイント）を指定する機能が強化され、より正確なルート案内と到着時のエクスペリエンスの向上が実現されています。これは、複数の入り口がある目的地や特定のナビゲーション ポイントがある目的地で特に有効です。navigationPointToken を使用して、正確な位置情報にルートを設定できます。これは、位置情報と追加のルート コンテキストをエンコードする文字列です。緯度と経度の座標をプレイス ID と組み合わせて、コンテキストを追加することもできます。

背景

v7.4 より前は、緯度と経度の座標またはプレイス ID を使用して Waypoint を定義できました。緯度と経度のみをルーティングに使用すると、特に大規模な会場、公園、複数の入り口がある建物などでは、最適な降車場所や乗車場所が選択されないことがあります。結果が最も近い道路セグメントにスナップされることがありますが、これは最も便利または正しいナビゲーション ポイントではない可能性があります。

拡張されたウェイポイント オプションでは、より多くのコンテキストを提供することで、この問題に対処しています。

ナビゲーション ポイント トークンを使用する

入口、荷積みドック、指定された乗車エリアなどの特定のナビゲーション ポイントへの最も正確なルートを検索するには、navigationPointToken を使用します。このトークンは、Geocoding API の destinations メソッドを呼び出すことで取得されます。これは、場所に関連付けられた、ルート設定可能な特定のナビゲーション ポイントを表します。

ナビゲーション ポイント トークンを指定するには:

1. Geocoding API の Destinations メソッドのレスポンスから navigationPointToken を取得します。
2. ビルダーの setNavigationPointToken() メソッドを使用して Waypoint を作成します。

// Assuming 'navPointToken' is a String obtained from the destinations method of the Geocoding API
// Assuming 'destinationName' is a String title for the waypoint

Waypoint waypointWithToken = Waypoint.builder()
    .setTitle(destinationName)
    .setNavigationPointToken(navPointToken)
    .build();

// Use this waypoint in navigator.setDestinations()

ナビゲーション ポイント トークンとルートトークンを使用する

Geocoding API を介してナビゲーション ポイント トークンを取得し、Routes API からルートトークンを取得して、ナビゲーション ポイント トークンとルートトークンの両方を Navigation SDK に渡すことができます。これは、ライドシェアや配達などのシナリオで、Routes API を使用して移動料金を計算し、ナビゲーション ポイント トークンの精度が必要な場合に便利です。

Navigation SDK は、ルートトークンを使用して、料金の計算に使用したルートと同じルートでナビゲーションを開始します。これにより、乗車に長いルートや短いルートが使用されるリスクが軽減され、「価格ショック」が発生する可能性があります。

ナビゲーション ポイント トークンを使用して場所を指定する方法とルートトークンを作成する方法について詳しくは、Routes API の API ドキュメントをご覧ください。ルートトークンを使用してルートを計画する方法については、ルートを計画するをご覧ください。

次の図は、ライドシェアまたは配達アプリでナビゲーション ポイント トークンとルートトークンを組み合わせて使用する方法を示しています。

プレイス ID と緯度、経度を組み合わせる

v7.4 以降では、Waypoint の作成時にプレイス ID と緯度経度座標の両方を指定できます。このメソッドは、場所全体のコンテキスト（プレイス ID）を提供しながら、正確なポイント（緯度/経度）を指定する場合に便利です。これにより、Navigation SDK は、目的地の建物をハイライト表示したり、プレイス ID に関連する近くのスポットを表示したりして、より充実した到着エクスペリエンスを提供できます。

// Assuming 'placeId' is the Place ID String
// Assuming 'lat' and 'lng' are the double values for latitude and longitude
// Assuming 'destinationName' is a String title for the waypoint

Waypoint waypointWithPlaceIdAndLatLng = Waypoint.builder()
    .setTitle(destinationName)
    .setPlaceIdString(placeId)
    .setLatLng(lat, lng)
    .build();

// Use this waypoint in navigator.setDestinations()

考慮事項

placeId と latlng の両方を指定する場合:

• このルートは、主に指定された latlng をターゲットにします。
• placeId は、到着時のエクスペリエンスを向上させるためのコンテキストとして使用されます。
• 代替: SDK が、指定された placeId が指定された latlng から遠すぎる機能に対応していると判断した場合、placeId は無視されます。このシナリオでは、latlng へのルートのみが設定され、場所固有の到着エクスペリエンスの向上は利用できません。

有効なウェイポイント構成の概要