計算路線矩陣的通行費

計算路徑矩陣時，建議您一併考量矩陣中所有路徑的費用。對於特定城市，您可以使用適當幣別計算路線的預估費用。

如要查詢路線的收費站，請參閱「計算路線的過路費」。

如需支援的收費站地點清單，請參閱 TollPass 參考資料。

路線矩陣通行費範例

以下範例使用 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
           }
        ]
      }
    }
  }
]