計算過路費

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

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

收費路段

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

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