計算路徑或路徑矩陣時,建議您考量路線上的任何手續費。針對某些城市,您可以使用適當的貨幣計算路線的預估通行費。
請參閱下方的支援目的地地點清單。
收費路段
Routes API 會計算預估道路收費費,並將駕駛或車輛可用的任何降價折扣或票證,以及便利的付款方式。如果特定路線沒有收費路段,Routes API 會指出包含不明費用的收費路段。
為了精確計算收費路段資訊,Routes API 可讓您指定以下選項:
- 路線的交通工具排放量類型 (
VehicleEmissionType
)。如未提供交通工具類型,系統會傳回燃油車廂的收費路段。 - 適用的司機或車輛適用的收費路段 (
TollPass
)。如未指定付費路段,API 會傳回現金價格。 - 為
RouteModifier
,將avoidTolls
改為收費路段。
使用道路收費通行費時計算通行費
在某些地區,有道路通行證的駕駛或車輛費用不同,且沒有票證。舉例來說,如果您搭乘 Good to Go! 道路前往美國華盛頓州西雅圖的通行費,費用就會低於沒有票證。
部分地區 (例如印尼) 具有道路收費路段,如果路線沒有指定收費路段,則無收費通行證。
如果您在要求中指定了收費路段,API 會嘗試傳回票證價格:
如果指定無效收費通行證,系統就會略過該票證。
您可以指定多個收費路段做為陣列。API 會嘗試計算票證中的每個票證的票證價格。
計算路線的通行費
以下範例使用 computeRoutes
方法,傳回使用道路收費通行證時的預估費用資訊。在這個範例中,您將:
將
extraComputations
陣列欄位設為TOLLS
,即可計算收費資訊。請使用要求的
routeModifiers
欄位指定車輛類型和收費路段類型。系統會根據指定車輛類型及傳遞的定價來傳回車資價格。如果指定多張票證,系統會傳回最低價。使用回應欄位遮罩設定方法,在回應中傳回收費資訊。在此範例中,要求會在回應欄位遮罩中加入下列屬性:
routes.travelAdvisory.tollInfo
欄位會傳回整條路線的資訊。routes.legs.travelAdvisory.tollInfo
會傳回每個路段的資訊。
索取收費資訊
curl -X POST -d '{
"origin":{
"location":{
"latLng":{
"latitude":42.340173523716736,
"longitude":-71.05997968330408
}
}
},
"destination":{
"location":{
"latLng":{
"latitude":42.075698891472804,
"longitude": -72.59806562080408
}
}
},
"travelMode": "DRIVE",
"extraComputations": ["TOLLS"],
"routeModifiers":{
"vehicleInfo":{
"emissionType": "GASOLINE"
},
"tollPasses": [
"US_MA_EZPASSMA",
"US_WA_GOOD_TO_GO"
]
}
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.travelAdvisory.tollInfo,routes.legs.travelAdvisory.tollInfo' \
'https://routes.googleapis.com/directions/v2:computeRoutes'
回應含有收費路段資訊
回應中包含 TollInfo (REST) 或 TollInfo (gRPC) 物件中的收費路段相關資訊。在這個範例中,系統會傳回整條路線的路段和每條路段的收費資訊。
{ "routes": [ { "legs": [ { "travelAdvisory": { "tollInfo": { "estimatedPrice": [ { "currencyCode": "USD", "units": "4", "nanos": 400000000 } ] } } } ], "distanceMeters": 150338, "duration": "6650s", "travelAdvisory": { "tollInfo": { "estimatedPrice": [ { "currencyCode": "USD", "units": "4", "nanos": 400000000 } ] } } } ] }
計算路線矩陣的通行費
以下範例使用 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 } ] } } } ]
支援的付費地點
目前僅有下列地區提供收費資訊:
區碼 | 國家/地區 | 州/省/道路 |
---|---|---|
AR | 阿根廷 | 布宜諾斯艾利斯 |
AU | 澳洲 | 布里斯本 |
AU | 澳洲 | 雪梨 |
巴西 | 巴西 | 全國 |
ID | 印尼 | 全國 |
印度 | 印度 | 全國 |
MX | 墨西哥 | 墨西哥城 |
美國 | United States | 阿拉巴馬州 |
美國 | United States | 阿拉斯加州 |
美國 | United States | 加州 |
美國 | United States | 科羅拉多州 |
美國 | United States | 德拉瓦州 |
美國 | United States | 佛羅里達州 |
美國 | United States | 伊利諾州 |
美國 | United States | 愛荷華州 |
美國 | United States | 印第安納州 |
美國 | United States | 堪薩斯州 |
美國 | United States | 路易斯安那州 |
美國 | United States | 緬因州 |
美國 | United States | 馬里蘭州 |
美國 | United States | 麻薩諸塞州 |
美國 | United States | 密西根州 |
美國 | United States | 明尼蘇達州 |
美國 | United States | 密蘇里州 |
美國 | United States | 新罕布夏州 |
美國 | United States | 紐澤西洲 |
美國 | United States | 紐約 |
美國 | United States | 北卡羅來納州 |
美國 | United States | 俄亥俄州 |
美國 | United States | 賓州 |
美國 | United States | 羅德島州 |
美國 | United States | 南卡羅來納州 |
美國 | United States | 德州 |
美國 | United States | 猶他州 |
美國 | United States | 維吉尼亞州 |
美國 | United States | 華盛頓州 |
美國 | United States | 西維吉尼亞州 |
收到更多收費資料時,我們會更新這項資訊。