計算路線的通行費

計算路徑或路徑矩陣時 不妨考慮航線的任何收費 對於特定城市,您可以計算 費用。

如要取得路線矩陣的收費站資訊,請參閱 計算路線矩陣的過路費

如需支援的收費站地點清單,請參閱 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
            }
          ]
        }
      }
    }
  ]
}