使用導航點權杖規劃路線

歐洲經濟區 (EEA) 開發人員

導航點權杖可讓您將目的地的重要背景資訊傳送至 Android 適用的 Navigation SDK，進而改善路線規劃和駕駛體驗。這項功能適用於外送或共乘等服務，因為如果沒有使用者輸入資訊，取貨或下車地點可能會不清楚。

這張圖片顯示消費者叫車應用程式的範例，其中已選取導航點，以及使用 Navigation SDK for Android 精確規劃駕駛路線的駕駛人應用程式。

消費者和駕駛人應用程式範例

如要建立及傳遞導航點權杖，請使用 Geocoding API 的 Destinations 端點，讓使用者從導航點清單中選取偏好的位置。使用者選取的地點會成為導航點，由 Geocoding API 的 Destinations 端點傳回。接著，您可以將導航點權杖 (包含目的地座標和情境資訊) 傳遞至 Android 版 Navigation SDK，系統會建立途中的航點，以便規劃精確路線。Navigation SDK 會根據權杖相關聯的地點，為駕駛人醒目顯示目的地。

如何建立導航點權杖並傳送至 Nav SDK 以進行路徑規劃

舉例來說，假設是代僱駕駛服務，消費者會使用一個應用程式預約行程，而駕駛人則會使用另一個應用程式接收行程通知，以及前往目的地的路線資訊。

消費者開啟消費者應用程式時，應用程式會呼叫 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
      }
      }
    }
]

回應中的導航點權杖會傳遞至使用 Navigation SDK for Android 的行動裝置駕駛人應用程式，藉此建立Waypoint，引導駕駛人前往正確的接送地點。