取得路徑權杖

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

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

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

1. 設定下列參數，以便傳回路線權杖：
   • 將 travelMode 設為 DRIVE 或 TWO_WHEELER。
   • 將 routingPreference 設為 TRAFFIC_AWARE 或 TRAFFIC_AWARE_OPTIMAL。
2. 指定起點和目的地。您可以透過經緯度座標、地址字串、導航點權杖或地點 ID，指定符合使用案例的位置。查看位置規格選項。
3. 確認路線航點都不是 Via 航點。

4. 指定 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 參考資料」。