取得路徑權杖

如要要求 Routes API 傳回產生路線的路線權杖，請按照下列步驟操作：

  1. 設定下列必要參數，以便傳回路徑符記：

    • 將 travelMode 設為 DRIVE。
    • 將 routingPreference 設為 TRAFFIC_AWARE 或 TRAFFIC_AWARE_OPTIMAL。

  2. 確認路線的所有中途點都不是經過中途點。

  3. 指定 routes.routeToken 欄位遮罩，以便傳回路徑權杖：

    X-Goog-FieldMask: routes.routeToken<

您可以在 Navigation SDK 中使用路線憑證，為所規劃的路線進行規劃。相關詳情請參閱：

路徑符記範例

以下是單一起點、單一目的地的路線的 cURL 要求主體範例。它會使用欄位遮罩來要求路線符記，以及路線時間、距離和路線多邊形：

curl -X POST -d
{"origin":{
    "location": {
        "latLng":{
            "latitude":  -37.8167,
            "longitude": 144.9619
        }
    }
},
"destination":{
    "location": {
        "latLng":{
            "latitude":-37.8155,
            "longitude": 144.9663
        }
    }
},
"routingPreference":"TRAFFIC_AWARE",
"travelMode":"DRIVE"
}
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H X-Goog-FieldMask: routes.routeToken,routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
'https://routes.googleapis.com/directions/v2:computeRoutes'

詳情請參閱 Compute Routes API 參考資料。