경로 행렬의 통행료 계산

경로 매트릭스를 계산할 때는 매트릭스의 경로에 부과되는 통행료 요금을 고려하는 것이 좋습니다. 일부 도시의 경우 경로의 예상 통행료 요금을 적절한 통화로 계산할 수 있습니다.

경로의 통행료를 확인하려면 경로의 통행료 계산을 참고하세요.

지원되는 통행료 위치 목록은 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
           }
        ]
      }
    }
  }
]