통행료 계산

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

아래에서 지원되는 수신자 부담 위치 목록을 참조하세요.

통행료 계산 방법

Routes API는 운전자 또는 차량에 제공되는 통행료 할인 또는 패스와 가장 편리한 결제 수단을 고려하여 예상 통행료를 계산합니다. 지정된 경로에 이용 가능한 통행료가 없는 경우 Routes API는 알 수 없는 수수료를 사용하는 통행료가 있음을 나타냅니다.

Routes API는 통행료 정보를 정확하게 계산하기 위해 다음을 지정할 수 있는 옵션을 제공합니다.

  • 경로에 사용되는 차량의 배출량 유형(VehicleEmissionType)입니다. 배출 유형이 제공되지 않으면 휘발유 연료 차량의 통행료가 반환됩니다.
  • 적용될 수 있는 운전자 또는 차량의 톨 패스(TollPass). 통행료를 지정하지 않으면 API에서 현금 가격을 반환합니다.
  • 유료 도로를 우회하기 위해 RouteModifier로서 avoidTolls.

톨 패스 사용 시 통행료 계산

톨 패스가 있는 운전자 또는 차량은 통행료가 없는 사용자와는 다른 톨 요금을 지불합니다. 예를 들어 미국 워싱턴주 시애틀에 Good To Go! 통행료가 있다면 패스가 없을 때보다 더 적은 통행료를 지불합니다.

인도네시아와 같은 일부 지역에는 유료도로가 필요한 도로가 있습니다. 톨 패스가 필요한 경로에 톨 패스가 지정되어 있지 않으면 가격이 반환되지 않습니다.

요청의 일부로 통행료를 지정하면 API에서 패스 가격을 반환하려고 시도합니다.

  • 잘못된 톨 패스를 지정하면 패스가 무시됩니다.

  • 여러 개의 톨 패스를 배열로 지정할 수 있습니다. API는 각 패스의 경로에 대해 패스 가격을 계산하려고 시도합니다.

경로의 통행료 계산

다음 예에서는 computeRoutes 메서드를 사용하여 톨 패스가 사용될 때 예상 가격으로 통행료 정보를 반환합니다. 이 예에서 다음을 수행합니다.

  • 통행료 정보 계산을 사용 설정하려면 extraComputations 배열 필드를 TOLLS로 설정합니다.

  • 요청의 routeModifiers 필드를 사용하여 차량 유형과 톨 패스 유형을 지정하세요. 반환되는 통행료는 지정된 차량 유형과 패스에 사용되는 가격을 기준으로 합니다. 패스가 두 개 이상 지정되면 최저가가 반환됩니다.

  • 응답 필드 마스크를 사용하여 응답에 통행료 정보를 반환하는 메서드를 구성합니다. 이 예에서 요청의 응답 필드 마스크에는 다음 속성이 포함되어 있습니다.

    • routes.travelAdvisory.tollInfo 필드를 사용하여 전체 경로에 대한 정보를 반환합니다.

    • routes.legs.travelAdvisory.tollInfo - 각 구간의 정보를 반환합니다.

통행료 정보 요청

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude":42.340173523716736,
        "longitude":-71.05997968330408
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude":42.075698891472804,
        "longitude": -72.59806562080408
      }
    }
  },
  "travelMode": "DRIVE",
  "extraComputations": ["TOLLS"],
  "routeModifiers":{
    "vehicleInfo":{
      "emissionType": "GASOLINE"
    },
    "tollPasses": [
      "US_MA_EZPASSMA",
      "US_WA_GOOD_TO_GO"
    ]
  }
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.travelAdvisory.tollInfo,routes.legs.travelAdvisory.tollInfo' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

통행료 정보가 포함된 응답

응답에는 TollInfo (REST) 또는 TollInfo (gRPC) 객체의 통행료 정보가 포함됩니다. 이 예에서는 전체 경로와 경로의 각 구간에 대한 통행료 정보를 반환합니다.

{
  "routes": [
    {
      "legs": [
        {
          "travelAdvisory": {
            "tollInfo": {
              "estimatedPrice": [
                {
                  "currencyCode": "USD",
                  "units": "4",
                  "nanos": 400000000
                }
              ]
            }
          }
        }
      ],
      "distanceMeters": 150338,
      "duration": "6650s",
      "travelAdvisory": {
        "tollInfo": {
          "estimatedPrice": [
            {
              "currencyCode": "USD",
              "units": "4",
              "nanos": 400000000
            }
          ]
        }
      }
    }
  ]
}

경로 매트릭스의 통행료 계산

다음 예에서는 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
           }
        ]
      }
    }
  }
]

지원되는 통행료 위치

현재 다음 위치에서 통행료 정보가 제공됩니다.

지역 코드국가/지역시/도/유료 도로
AR 아르헨티나 부에노스 아이레스
AU 오스트레일리아 브리스번
AU 오스트레일리아 시드니
BR 브라질 전국
ID 인도네시아 전국
IN 인도 전국
MX 멕시코 멕시코 시티
US 미국 앨라배마
US 미국 알래스카
US 미국 캘리포니아
US 미국 콜로라도
US 미국 델라웨어
US 미국 플로리다
US 미국 일리노이
US 미국 아이오와
US 미국 인디애나
US 미국 캔자스
US 미국 루이지애나
US 미국 메인
US 미국 메릴랜드
US 미국 매사추세츠
US 미국 미시간
US 미국 미네소타
US 미국 미주리
US 미국 뉴햄프셔
US 미국 뉴저지
US 미국 뉴욕
US 미국 노스캐롤라이나
US 미국 오하이오
US 미국 펜실베이니아
US 미국 로드아일랜드
US 미국 사우스캐롤라이나
US 미국 텍사스
US 미국 유타
US 미국 버지니아
US 미국 워싱턴
US 미국 웨스트버지니아

통행료 데이터가 더 제공되면 이 정보가 업데이트됩니다.