使用導航點權杖規劃路線

歐洲經濟區 (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，以及 iOS 或 Android 適用的 Navigation SDK，透過路線權杖和導航點權杖為司機規劃路線：

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

共乘範例

假設在共乘情境中，消費者使用一個應用程式預約行程，而司機則使用另一個應用程式接收行程通知和前往目的地的路線資訊。

這張圖片顯示消費者共乘應用程式 (已選取導航點) 和司機應用程式 (使用 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，以便計算路線並擷取路線權杖。

最後，導航點權杖和路線權杖都會傳遞至行動司機應用程式，該應用程式會使用 iOS 或 Android 版 Navigation SDK 建立路線控點，將司機導航至正確的上車地點。

延伸閱讀