計算路線矩陣的通行費

計算路徑矩陣時，建議您考量矩陣中路線的任何過路費。針對特定城市，您可以 以適用幣別計算航線的預估過路費

如要取得某條路線的收費站，請參閱「計算路線的過路費」一文。

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

注意： 計算過路費的要求會以較高的費率計費。進一步瞭解 Routes API 的計費方式。

路線矩陣收費範例

以下範例使用 computeRouteMatrix 方法，在使用通行費票證時，傳回包含預估價格的路線資訊：

• 將 extraComputations 陣列欄位設為 TOLLS，即可計算收費資訊。

• 使用要求起點路線控點的 routeModifiers 欄位，指定交通工具類型和收費站類型。傳回的通行費價格是以指定車輛類型和票證使用的定價計算，如果指定多張票證，系統會傳回價格最低的定價。

• 使用回應欄位遮罩來設定方法，即可在回應中傳回收費資訊。指定 routes.travelAdvisory.tollInfo 即可傳回整個路線的資訊。

注意： 路徑矩陣不會傳回詳細的路線資訊，例如路線的路段、步驟和折線。如要取得詳細的路徑資訊，請將單一起點和單一目的地傳遞至 Compute Routes。

要求路線矩陣的收費資訊

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
           }
        ]
      }
    }
  }
]