前往導航點

Navigation SDK for iOS 提供更進階的方式來指定路線控點或導航點，可提供更準確的路線和更優質的抵達體驗，特別是針對有多個入口或特定導航點的目的地。您可以使用 navigationPointToken 規劃前往精確位置的路線，這是一種字串，可對位置和額外路線情境進行編碼。您也可以將經緯度座標與地點 ID 結合，提供更多背景資訊。

背景

在 10.10 版之前，您可以使用位置座標「或」地點 ID 定義 Waypoint。雖然有時有效，但僅根據經緯度規劃路線，有時可能會導致下車或上車地點不理想，尤其是大型場地、公園或有多個入口的建築物。結果可能會貼齊最近的路段，但這不一定是最方便或正確的存取點。

強化路線控點選項可讓您提供更多背景資訊，解決這個問題。

使用導航點代碼

如要精確規劃前往特定存取點 (例如入口、裝卸區或指定上車區) 的路線，可以使用 navigationPointToken。

呼叫 Geocoding API 的 Destinations 方法，即可取得這個權杖。代表與地點相關聯的特定可規劃路線導航點。

如要指定導航點權杖，請按照下列步驟操作：

  1. 從 Geocoding API 的 Destinations 方法回應中取得 navigationPointToken。

  2. 建立 GMSNavigationWaypoint 時，請指定 navigationPointToken。

Swift

// Create a waypoint using a navigation endpoint token
let waypointTwo = GMSNavigationWaypoint(
  navigationPointToken: "ChIJALijSXPhQkARHmIozCCbXsASEgkFVjYHGH6PgBFrbM7wl3..",
  title: "Sydney Opera House")

// Route to the waypoint
navigator.setDestinations([waypointTwo]) { [weak self] routeStatus in
   self?.handleRouteCallback(status: routeStatus)
}

Objective-C

GMSNavigationWaypoint *waypointTwo =
    [[GMSNavigationWaypoint alloc] initWithNavigationPointToken:@"sampleNavigationPointToken"
                                                          title:@"Sydney Opera House"];

使用導航點權杖和路線權杖

您可以透過 Geocoding API 擷取導航點權杖，並從 Routes API 擷取路線權杖，然後將這兩個權杖傳遞至 Navigation SDK。這項功能適用於共乘或外送等情境，您可以使用 Routes API 計算行程價格，並取得精確的導航點權杖。

有了路徑權杖，Navigation SDK 就能根據您用來計算價格的相同路徑開始導航。這可降低行程路線過長或過短的風險，避免「價格衝擊」。

如要進一步瞭解如何使用導航點權杖指定位置，以及建立路線權杖，請參閱 Routes API 說明文件。請參閱「規劃路線」，瞭解如何使用路線權杖規劃路線。

下圖顯示共乘或外送應用程式如何搭配使用導航點權杖和路線權杖：

共乘或外送用途圖表
共乘或外送用途圖表

結合地點 ID 和位置

從 10.10 版開始，您可以在建立路線控點時，同時提供地點 ID 和位置座標。如要指定精確點 (位置)，同時提供整體地點的背景資訊 (地點 ID)，這個方法就很實用。這樣一來，Navigation SDK 就能醒目顯示目的地建築物，或顯示與地點 ID 相關的附近搜尋點，提供更豐富的抵達體驗。

Swift

// Create a waypoint using both the latlng and placeID
let waypoint = GMSNavigationWaypoint(
  location: CLLocationCoordinate2DMake(-33.85657945261524, 151.21535034203333),  
  placeID: "ChIJ3S-JXmauEmsRUcIaWtf4MzE",
  title: "Sydney Opera House")

// Route to the waypoint
navigator.setDestinations([waypoint]) { [weak self] routeStatus in
   self?.handleRouteCallback(status: routeStatus)
}

Objective-C

CLLocationCoordinate2D location = CLLocationCoordinate2DMake(47.67, -122.20);
GMSNavigationWaypoint *waypoint = [[GMSNavigationWaypoint alloc] initWithLocation:placeID:coordinate title:@"waypoint from location and placeiD"];

注意事項：

如果同時提供 placeID 和 location：

  • 這條路徑主要指定 location。
  • placeId會做為情境資訊，提升抵達體驗。
  • 備用：如果 SDK 判定提供的 placeId 對應特徵與指定 location 距離太遠，則會忽略 placeId。在這種情況下，系統只會規劃前往 location 的路線，不會提供特定地點的抵達體驗強化功能。

有效路線控點設定摘要

規格 location placeID navigationPointToken 轉送行為 目的地醒目顯示
僅限位置座標 set 缺席 缺席 導向最接近指定座標的路段 如果能高度確信目的地，就會顯示
僅限地點 ID 缺席 set 缺席 前往地點 ID 的預設導航點 出發地點 ID
僅限導航點權杖 缺席 缺席 set 前往權杖代表的精確導航點 原始 Geocoding API 的目的地方法要求中定義的目的地
位置座標和地點 ID 組合 se set 缺席 導向最接近指定座標的路段 從地點 ID 取得，但如果地點 ID 與經緯度座標相距太遠，則不會顯示