計算過路費

計算路徑或路徑矩陣時,建議您考慮路徑中支付的任何費用。對於某些城市,您可以依據適用的幣別計算路線的預估收費費。

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

收費方式

Routes API 會估算預估的通行費,同時考量駕駛或車輛可用的通行費或通行費,以及最便利的付款方式。如果特定路線沒有可用道路收費,Routes API 則代表有通行費存在的不明費用。

為了準確計算道路收費資訊,Routes API 提供以下選項:

  • 路線使用的車輛排放類型 (VehicleEmissionType)。如未提供碳排放類型,則會傳回汽油車輛的收費路段。
  • 可能適用的駕駛或車輛通行費 (TollPass)。如未指定道路收費通行證,API 會傳回現金價格。
  • avoidTolls:作為RouteModifier,避開收費路段。

使用道路收費通行證時計算道路收費

在某些地區,有通行費的司機或車輛支付通行費,而沒有通行證的人則需要支付不同的通行費。舉例來說,如果您有一個 好極了! 美國華盛頓州西雅圖收費通行證,付出的通行證會比沒有通行證的低。

某些地區 (例如印尼) 的部分道路需要收費路段。如果未指定道路收費通行證,且沒有指定道路收費,則不會傳回任何價格。

如果您在要求中指定了收費路段,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,即可計算道路收費資訊。

  • 使用要求的 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
           }
        ]
      }
    }
  }
]

支援的收費站

目前可使用以下地區的收費資訊:

區域代碼國家/地區州/省/市/收費路段
AR 阿根廷 布宜諾斯艾利斯
澳洲 澳洲 布里斯本
澳洲 澳洲 雪梨
巴西 巴西 全國
ID 印尼 全國
印度 印度 全國
MX 墨西哥 墨西哥城
美國 美國 阿拉巴馬州
美國 美國 阿拉斯加州
美國 美國 加州
美國 美國 科羅拉多州
美國 美國 德拉瓦州
美國 美國 佛羅里達州
美國 美國 伊利諾州
美國 美國 愛荷華州
美國 美國 印第安納州
美國 美國 堪薩斯州
美國 美國 路易斯安那州
美國 美國 緬因州
美國 美國 馬里蘭州
美國 美國 麻薩諸塞州
美國 美國 密西根州
美國 美國 明尼蘇達州
美國 美國 密蘇里州
美國 美國 新罕布夏州
美國 美國 紐澤西洲
美國 美國 紐約
美國 美國 北卡羅來納州
美國 美國 俄亥俄州
美國 美國 賓州
美國 美國 羅德島州
美國 美國 南卡羅來納州
美國 美國 德州
美國 美國 猶他州
美國 美國 維吉尼亞州
美國 美國 華盛頓州
美國 美國 西維吉尼亞州

之後如有更多收費資料,系統會更新這項資訊。