計算過路費

計算路徑或路徑矩陣時,建議您考量路線上的任何手續費。針對某些城市,您可以使用適當的貨幣計算路線的預估通行費。

請參閱下方的支援目的地地點清單。

收費路段

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 西維吉尼亞州

收到更多收費資料時,我們會更新這項資訊。