計算路徑矩陣時,建議您一併考量矩陣中所有路徑的費用。對於特定城市,您可以使用適當幣別計算路線的預估費用。
如要查詢路線的收費站,請參閱「計算路線的過路費」。
如需支援的收費站地點清單,請參閱 TollPass 參考資料。
路線矩陣通行費範例
以下範例使用 computeRouteMatrix
方法,在使用收費票證時,傳回包含預估價格的路線收費資訊:
將
extraComputations
陣列欄位設為TOLLS
,即可計算過路費資訊。使用要求 origin 路線控點的
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 } ] } } } ]