計算路線矩陣的通行費

計算路線矩陣時，您可能需要考量矩陣中路線的任何通行費。針對特定城市，您可以使用適當的幣別計算路線的預估過路費。

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

如需支援的通行路段位置清單，請參閱 TollPass 的參考資料。

路線矩形圖通行費示例

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