Android 版 Navigation SDK 提供更完善的航點或導航點指定方式，可提供更準確的路線規劃，以及更優質的抵達體驗，特別是針對有多個入口或特定導航點的目的地。您可以使用 navigationPointToken 導向精確位置，這是編碼位置和額外路線環境的字串。您也可以將經緯度座標與地點 ID 結合，加入更多背景資訊。
背景
在 7.4 版之前，您可以透過經緯度座標或地點 ID 定義 Waypoint。雖然有時有效，但僅根據緯度和經度規劃路線有時會導致下車或上車地點不理想，尤其是大型場地、公園或有多個入口的建築物。結果可能會對齊到最近的路段，但這可能不是最方便或正確的導航點。
加強型航點選項可提供更多背景資訊，解決這個問題。
使用導覽點權杖
如要規劃前往特定導覽點 (例如入口、裝卸碼頭或指定取貨區) 的最精確路線，可以使用 navigationPointToken。呼叫 Geocoding API 的目的地方法即可取得這個權杖。代表與地點相關聯的特定可路由導覽點。
如要指定導覽點權杖，請按照下列步驟操作：
- 從 Geocoding API 的 Destinations 方法回應中取得
navigationPointToken。 - 使用建構工具中的
setNavigationPointToken()方法建立Waypoint。
附註：使用 setNavigationPointToken() 時，無法同時使用 setLatLng() 或 setPlaceIdString()。這些方法與 setNavigationPointToken() 互斥。
// 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 說明文件。請參閱「規劃路線」，瞭解如何使用路線權杖規劃路線。
這張圖表顯示共乘或外送應用程式如何一併使用導覽點權杖和路線權杖：
結合地點 ID 與經緯度
從 7.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，且無法提供地點專屬的抵達體驗強化功能。
有效路線控點設定摘要
| 方法 | setLatLng() |
setPlaceIdString() |
setNavigationPointToken() |
轉送行為 | 目的地醒目顯示 |
|---|---|---|---|---|---|
| 僅限經緯度座標 | set | 缺席 | 缺席 | 前往最接近所定義座標的路段 | 如果系統能以高可信度推斷目的地，就會顯示這項資訊 |
| 僅限地點 ID | 缺席 | set | 缺席 | 前往地點 ID 預設導航點的路線 | 起點地點 ID |
| 僅限導航點權杖 | 缺席 | 缺席 | set | 前往權杖所代表精確導航點的路線 | 來自原始 Geocoding API 要求的 destinations 方法中定義的目的地 |
| 經緯度座標和地點 ID 的組合 | set | set | 缺席 | 前往最接近所定義座標的路段 | 來自地點 ID，但如果地點 ID 與經緯度座標相距太遠，則不會顯示 |