获取路线令牌

欧洲经济区 (EEA) 开发者

如果您的账单邮寄地址在欧洲经济区，自 2025 年 7 月 8 日起，您在使用服务时需遵守 Google Maps Platform EEA 服务条款。具体功能因地区而异。 了解详情。

如需请求 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 参考文档。