計算路線矩陣的通行費

計算路線矩陣時，您可能想將矩陣中路線的任何過路費納入考量。在特定城市，你可以計算路線的預估通行費，並以適當幣別顯示。

如要取得路線的通行費，請參閱「計算路線的通行費」。

如需支援的收費站位置清單，請參閱「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
           }
        ]
      }
    }
  }
]