在计算路线矩阵时,您可能需要考虑矩阵中路线的所有过路费。对于部分城市,您可以计算相应路线的估算过路费(以相应币种显示)。
如需获取路线的过路费,请参阅计算路线的过路费。
如需查看支持的过路费收费位置列表,请参阅 TollPass 参考文档。
路线矩阵收费站示例
以下示例使用 computeRouteMatrix
方法返回路线的过路费信息,并附带使用过路费卡时的预估价格:
将
extraComputations
数组字段设置为TOLLS
,以启用计算过路费信息的功能。使用请求的起点航点的
routeModifiers
字段指定车辆类型和过路费卡类型。返回的通行费基于指定车辆类型和卡券使用的价格。如果指定了多个卡券,系统会返回价格最低的卡券。使用响应字段掩码配置该方法,以便在响应中返回过路费信息。指定
routes.travelAdvisory.tollInfo
以返回整个路线的信息。
请求路线矩阵收费信息
curl -X POST -d '{ "origins": [ { "waypoint": { "location": { "latLng": { "latitude":42.340173523716736, "longitude":-71.05997968330408 } } }, "routeModifiers": { "vehicleInfo":{ "emissionType": "GASOLINE" }, "tollPasses": [ "US_MA_EZPASSMA", "US_WA_GOOD_TO_GO" ] } } ], "destinations": [ { "waypoint": { "location": { "latLng": { "latitude":42.075698891472804, "longitude": -72.59806562080408 } } } } ], "travelMode": "DRIVE", "extraComputations": ["TOLLS"] }' \ -H 'Content-Type: application/json' \ -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: originIndex,destinationIndex,travel_advisory.tollInfo,duration,distanceMeters,status' \ 'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'
对路线矩阵收费信息的响应
响应包含 TollInfo (REST) 或 TollInfo (gRPC) 对象中的过路费信息。
如需配置用于返回过路费信息的方法,请使用响应字段掩码在掩码中设置 travelAdvisory.tollInfo
字段。
[ { "originIndex": 0, "destinationIndex": 0, "status": {}, "distanceMeters": 150338, "duration": "5382s", "travelAdvisory": { "tollInfo": { "estimatedPrice": [ { "currencyCode": "USD", "units": "4", "nanos": 400000000 } ] } } } ]