計算路線或路線矩陣時,您可能需要考量路線上的任何通行費。對於特定城市,您可以計算 費用。
如要取得路線矩陣的收費站資訊,請參閱 計算路線矩陣的過路費。
如需支援的通行路段位置清單,請參閱 TollPass 的參考資料。
收費方式
Routes API 會計算預估收費 考量任何適用的收費折扣或通行證 以及最便利的付款方式 如果特定航線沒有收費路段, Routes API 會指出收費是否存在 收取手續費
如要取得準確的預估收費金額,請務必納入下列資訊 :
- 路線車輛的排放量類型
(
VehicleEmissionType
). 如未提供碳排放類型,那麼油電車油資將會 。 - 車輛和駕駛人擁有的所有通行證 (使用
TollPass
)。API 會使用通行證判斷正確的通行費,並在要求中的通行證不是路線當地的情況下傳回現金價格。 - 視需要指定避開收費路段。如要避開收費路段
請將
avoidTolls
新增為RouteModifier
。
使用收費通行證計算過路費
如要使用通行卡計算過路費,請在要求中指定任何通行卡。接著,API 會傳回票證價格。
如果指定無效的收費通行證,系統就會忽略該票證。
如果指定多個收費路段做為陣列,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 } ] } } } ] }