取得路徑權杖

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

如果您的帳單地址位於歐洲經濟區，自 2025 年 7 月 8 日起，使用服務時將適用《 Google 地圖平台歐洲經濟區服務條款》。功能會因區域而異。 瞭解詳情。

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

1. 設定下列參數，以便傳回路線權杖：

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

2. 確認路線航點都不是途經航點。

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

   X-Goog-FieldMask: routes.routeToken
   

注意： 由於路況會動態變化，使用特定權杖產生的路線可能與規劃路線不同。為盡量減少差異，請在產生權杖後幾分鐘內使用權杖。

您可以在 Navigation SDK 中使用規劃路線的路線權杖。 相關詳情請參閱：

• 規劃路線 (Android)
• 規劃路線 (iOS)

路徑權杖範例

以下是單一來源和單一目的地路徑的 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 參考資料。