경로의 통행료 계산

경로 또는 경로 행렬을 계산할 때 경로에 있는 통행료를 고려하는 것이 좋습니다. 일부 도시의 경우 특정 기간에 대한 예상 통화료를 부과합니다.

경로 매트릭스의 통행료를 확인하려면 다음을 참조하세요. 경로 매트릭스의 통행료를 계산합니다.

지원되는 유료 통화 위치 목록은 다음을 참조하세요. TollPass

통행료 계산 방법

Routes API는 예상 통행료를 계산하여 통행료 할인이나 통행료를 받을 때 가장 편리한 결제 수단을 제공합니다. 특정 경로에 통행료가 없는 경우 Routes API는 유료 도로의 존재를 나타냅니다. 알 수 없는 수수료가 청구됩니다.

정확한 예상 통행료를 확인하려면 다음 정보를 포함해야 합니다. 다음과 같습니다.

  • 경로에 사용된 차량의 배출 유형 (VehicleEmissionType). 배출 유형을 제공하지 않는 경우 휘발유 차량의 통행료는 다음과 같습니다. 반환합니다.
  • 모든 통행료는 차량과 운전자가 (TollPass). API는 정확한 통행료를 결정하고 현금 가격을 반환합니다. 요청의 톨 패스가 경로 지역 내에 있지 않은 경우.
  • 필요한 경우 통행료를 피하도록 지정합니다. 유료 도로를 제외하려면 가능한 경우 avoidTolls를 RouteModifier로 추가합니다.

톨 패스를 사용해 통행료 계산

톨 패스를 사용하여 통행료를 계산하려면 톨 패스를 요청을 처리합니다 그러면 API가 패스 가격을 반환합니다.

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

  • 여러 통행료를 배열로 지정하면 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
            }
          ]
        }
      }
    }
  ]
}