使用導航點權杖規劃路線

歐洲經濟區 (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、iOS 版 Navigation SDK 和 Android 版 Navigation SDK 說明文件連結，請參閱「延伸閱讀」一節。

下圖說明共乘或外送應用程式如何使用 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 的行動裝置駕駛人應用程式，以建立路線控點，將駕駛人導向正確的上車地點。

延伸閱讀