통행료 계산

유럽 경제 지역 (EEA) 개발자

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

지원되는 통행료 위치 목록은 TollPass 참조를 확인하세요.

통행료 계산 방법

Routes API는 운전자 또는 차량에 적용되는 통행료 할인 또는 패스, 가장 편리한 결제 수단을 고려하여 예상 통행료를 계산합니다. 특정 경로에 사용할 수 있는 통행료가 없으면 Routes API는 알 수 없는 요금이 있는 통행료의 존재를 나타냅니다.

정확한 통행료 예상치를 확인하려면 요청에 다음 정보를 포함해야 합니다.

  • 경로에 사용된 차량의 배출 유형(VehicleEmissionType)입니다. 배출 유형이 제공되지 않으면 휘발유 차량의 통행료가 반환됩니다.
  • tollPasses를 사용하여 차량과 운전자가 보유한 모든 통행권 API는 통행료 카드를 사용하여 정확한 통행료를 확인하고 요청의 통행료 카드가 경로에 해당하지 않는 경우 현금 가격을 반환합니다.
  • 필요한 경우 유료도로 제외 지정 가능한 경우 유료 도로를 피하려면 avoidTolls를 RouteModifier로 추가하세요.

통행료 카드를 사용하여 통행료 계산

통행료 카드를 사용하여 통행료를 계산하려면 요청의 일부로 통행료 카드를 지정합니다. 그러면 API가 패스 가격을 반환합니다.

  • 잘못된 통행료 카드를 지정하면 카드가 무시됩니다.
  • 통행권을 배열로 여러 개 지정하면 API에서 각 통행권의 경로 가격을 계산하려고 시도합니다.

통행권의 작동 방식은 지역에 따라 다를 수 있습니다.

  • 통행료 카드가 있으면 요금이 더 저렴할 수 있음: 일부 지역에서는 통행료 카드가 있는 운전자 또는 차량이 카드가 없는 운전자보다 다른 통행료를 지불합니다. 예를 들어 Good To Go! 미국 워싱턴주 시애틀에서 통행권이 있으면 통행권이 없는 경우보다 통행료가 저렴합니다.
  • 일부 도로에서는 통행권이 필요할 수 있습니다: 인도네시아와 같은 일부 지역에는 통행권이 필요한 도로가 있습니다. 통행료가 필요한 경로에 대해 통행료 카드를 지정하지 않으면 API에서 통행료를 반환하지 않습니다.

경로의 통행료 계산

경로의 통행료를 계산하려면 다음 단계를 따르세요.

  • extraComputations 속성을 TOLLS로 설정합니다.
  • routeModifiers 속성을 사용하여 차량 유형과 통행료 카드 유형을 지정합니다.
  • 전체 경로의 통행료를 계산하려면 요청의 fields 속성에서 travelAdvisory를 요청하고 route.travelAdvisory.tollInfo를 읽어 전체 경로의 통행료 정보를 확인합니다.
  • 경로의 개별 구간에 대한 통행료를 계산하려면 요청의 fields 속성에서 legs를 요청하세요. route.legs[i].travelAdvisory.tollInfo를 읽어 각 구간의 통행료 정보를 확인하세요.

예

다음 예시 요청은 경로의 통행료를 요청하는 방법을 보여줍니다.

const requestWithTolls = {
  origin: 'Kirkland, WA',
  destination: 'University of Washington',
  travelMode: 'DRIVING',
  extraComputations: ['TOLLS'],
  routeModifiers: {
    vehicleInfo: {
      emissionType: 'GASOLINE',
    },
    tollPasses: ['US_WA_GOOD_TO_GO'],
  },
  fields: ['path', 'legs', 'distanceMeters', 'durationMillis', 'travelAdvisory'],
};