Route - Get Route Range

  • 참조
서비스:
Maps
API 버전:
1.0

시간, 거리 또는 연료 용량에 따라 특정 임계값 내에서 특정 지점에서 액세스할 수 있는 영역을 보여 주는 맵을 만드는 데 사용합니다.

Get Route Range (Isochrone) API는 지정된 연료, 에너지, 시간 또는 거리 예산에 따라 원점에서 도달할 수 있는 위치 집합을 계산하는 HTTP GET 요청입니다. 다각형 경계(또는 Isochrone)는 원점의 결과인 정확한 다각형 중심뿐만 아니라 시계 반대 방향으로 반환됩니다.

반환된 다각형은 제공된 등시선 내에서 POI를 검색하기 위해 내부 기하 도형 검색 과 같은 추가 처리에 사용할 수 있습니다.

GET https://atlas.microsoft.com/route/range/{format}?api-version=1.0&query={query}
선택적 매개 변수: 
GET https://atlas.microsoft.com/route/range/{format}?api-version=1.0&query={query}&fuelBudgetInLiters={fuelBudgetInLiters}&energyBudgetInkWh={energyBudgetInkWh}&timeBudgetInSec={timeBudgetInSec}&distanceBudgetInMeters={distanceBudgetInMeters}&departAt={departAt}&routeType={routeType}&traffic={traffic}&avoid={avoid}&travelMode={travelMode}&hilliness={hilliness}&windingness={windingness}&vehicleAxleWeight={vehicleAxleWeight}&vehicleWidth={vehicleWidth}&vehicleHeight={vehicleHeight}&vehicleLength={vehicleLength}&vehicleMaxSpeed={vehicleMaxSpeed}&vehicleWeight={vehicleWeight}&vehicleCommercial={vehicleCommercial}&vehicleLoadType={vehicleLoadType}&vehicleEngineType={vehicleEngineType}&constantSpeedConsumptionInLitersPerHundredkm={constantSpeedConsumptionInLitersPerHundredkm}&currentFuelInLiters={currentFuelInLiters}&auxiliaryPowerInLitersPerHour={auxiliaryPowerInLitersPerHour}&fuelEnergyDensityInMJoulesPerLiter={fuelEnergyDensityInMJoulesPerLiter}&accelerationEfficiency={accelerationEfficiency}&decelerationEfficiency={decelerationEfficiency}&uphillEfficiency={uphillEfficiency}&downhillEfficiency={downhillEfficiency}&constantSpeedConsumptionInkWhPerHundredkm={constantSpeedConsumptionInkWhPerHundredkm}&currentChargeInkWh={currentChargeInkWh}&maxChargeInkWh={maxChargeInkWh}&auxiliaryPowerInkW={auxiliaryPowerInkW}

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
format
 path True

ResponseFormat

원하는 응답 형식입니다. 값은 json 또는 xml일 수 있습니다.
api-version
 query True

string

Azure Maps API의 버전 번호.
query
 query True

number[]

범위 계산을 시작할 좌표입니다.
accelerationEfficiency
 query

number

double

차량이 가속할 때 연료에 저장된 화학 에너지를 운동 에너지로 변환하는 효율성을 지정합니다 (예: KineticEnergyGained/ChemicalEnergyConsumed). ChemicalEnergyConsumed 는 fuelEnergyDensityInMJoulesPerLiter를 사용하여 소비된 연료를 화학 에너지로 변환하여 얻습니다.

decelerationEfficiency와 페어링해야 합니다.

허용되는 값 범위는 0.0에서 1/decelerationEfficiency입니다.

합리적인 값: 연소 모델의 경우: 0.33, 전기 모델의 경우: 0.66
auxiliaryPowerInkW
 query

number

double

보조 시스템을 유지하는 데 사용되는 전력의 양을 kW(킬로와트)로 지정합니다.

AC 시스템, 라디오, 난방 등과 같은 장치 및 시스템으로 인해 소비를 지정하는 데 사용할 수 있습니다.

합리적인 값: 1.7
auxiliaryPowerInLitersPerHour
 query

number

double

차량의 보조 시스템을 유지하는 데 사용되는 연료의 양을 시간당 리터 단위로 지정합니다.

AC 시스템, 라디오, 난방 등과 같은 장치 및 시스템으로 인해 소비를 지정하는 데 사용할 수 있습니다.

합리적인 값: 0.2
avoid
 query

RouteAvoidType[]

경로를 결정할 때 경로 계산에서 피해야 하는 항목을 지정합니다. 한 요청에서 여러 번 지정할 수 있습니다. 예를 들어 '&avoid=motorways&avoid=tollRoads&avoid=ferries'입니다. 경로 범위 요청에서 이미UsedRoads 값을 사용하면 안 됩니다.
constantSpeedConsumptionInkWhPerHundredkm
 query

string

사용량의 속도 종속 구성 요소를 지정합니다.

속도/소비율 쌍의 순서가 지정되지 않은 목록으로 제공됩니다. 목록은 소비 곡선의 점을 정의합니다. 목록에 없는 속도에 대한 소비 속도는 다음과 같습니다.

  • 선형 보간으로, 지정된 속도가 목록의 두 속도 사이에 있는 경우

  • 그렇지 않으면 선형 외삽으로, 목록에서 가장 가까운 두 점에 의해 결정되는 상수(ΜConsumption/ΜSpeed)를 가정합니다.

목록에는 1~25포인트(포함)가 포함되어야 하며 동일한 속도에 대한 중복 지점을 포함하지 않을 수 있습니다. 단일 지점만 포함하는 경우 해당 지점의 사용률은 추가 처리 없이 사용됩니다.

가장 큰 속도에 대해 지정된 소비량은 끝에서 두 번째로 큰 속도보다 크거나 같아야 합니다. 이렇게 하면 외삽이 음수 소비율로 이어지지 않습니다.

마찬가지로 목록에서 가장 작은 두 속도에 대해 지정된 소비 값은 더 작은 속도에 대해 음의 소비율로 이어질 수 없습니다.

사용량 값(kWh/100km로 표시됨)의 유효한 범위는 0.01에서 100000.0 사이입니다.

합리적인 값: 50,8.2:130,21.3

이 매개 변수는 전기 소비 모델에 필요합니다.
constantSpeedConsumptionInLitersPerHundredkm
 query

string

사용량의 속도 종속 구성 요소를 지정합니다.

콜론으로 구분된 속도 & 소비율 쌍의 순서가 지정되지 않은 목록으로 제공됩니다. 목록은 소비 곡선의 점을 정의합니다. 목록에 없는 속도에 대한 소비 속도는 다음과 같습니다.

  • 선형 보간으로, 지정된 속도가 목록의 두 속도 사이에 있는 경우

  • 그렇지 않으면 선형 외삽으로, 목록에서 가장 가까운 두 점에 의해 결정되는 상수(ΜConsumption/ΜSpeed)를 가정합니다.

목록에는 1~25포인트(포함)가 포함되어야 하며 동일한 속도에 대한 중복 지점을 포함하지 않을 수 있습니다. 단일 지점만 포함하는 경우 해당 지점의 사용률은 추가 처리 없이 사용됩니다.

가장 큰 속도에 대해 지정된 소비량은 끝에서 두 번째로 큰 속도보다 크거나 같아야 합니다. 이렇게 하면 외삽이 음수 소비율로 이어지지 않습니다.

마찬가지로 목록에서 가장 작은 두 속도에 대해 지정된 소비 값은 더 작은 속도에 대해 음의 소비율로 이어질 수 없습니다.

사용량 값(l/100km로 표시됨)의 유효한 범위는 0.01에서 100000.0 사이입니다.

합리적인 값: 50,6.3:130,11.5

참고 : 이 매개 변수는 연소 소비 모델에 필요합니다.
currentChargeInkWh
 query

number

double

현재 전기 에너지 공급을 kWh(킬로와트시)로 지정합니다.

이 매개 변수는 maxChargeInkWh 매개 변수와 함께 존재합니다.

허용되는 값 범위는 maxChargeInkWh까지 0.0입니다.

합리적인 값: 43
currentFuelInLiters
 query

number

double

리터에서 연료의 현재 공급을 지정합니다.

합리적인 값: 55
decelerationEfficiency
 query

number

double

차량이 감속될 때 운동 에너지를 저장(소비되지 않음) 연료로 변환하는 효율성을 지정합니다 (예: ChemicalEnergySaved/KineticEnergyLost). ChemicalEnergySaved 는 연료EnergyDensityInMJoulesPerLiter를 사용하여 저장된(소비되지 않음) 연료를 에너지로 변환하여 얻습니다.

accelerationEfficiency와 페어링해야 합니다.

허용되는 값 범위는 0.0~1/accelerationEfficiency입니다.

합리적인 값: 연소 모델의 경우: 0.83, 전기 모델의 경우: 0.91
departAt
 query

string

date-time

선택적 표준 시간대 오프셋이 있는 RFC 3339 섹션 5.6에 정의된 값으로 dateTime 서식이 지정된 원본 지점에서 출발 날짜 및 시간입니다. 표준 시간대 오프셋을 지정하지 않으면 원점의 오프셋으로 간주됩니다.

  • 기본값: 지금
  • 기타 값: dateTime

예:

  • 2023-12-19T16:39:57
  • 2023-12-20T00:39:57+00:00

매개 변수는 departAt 와 함께 arriveAt사용할 수 없습니다.
distanceBudgetInMeters
 query

number

double

주행 거리를 사용하여 주행할 수 있는 최대 범위를 결정하는 미터의 거리 예산입니다. 소비 모델은 routeType이 에코인 경우에만 범위에 영향을 미칩니다.
정확히 하나의 예산(fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec 또는 distanceBudgetInMeters)을 사용해야 합니다.
downhillEfficiency
 query

number

double

차량이 고도( 예: ChemicalEnergySaved/PotentialEnergyLost)를 잃을 때 잠재적 에너지를 저장(소비되지 않음) 연료로 변환하는 효율성을 지정합니다. ChemicalEnergySaved 는 연료EnergyDensityInMJoulesPerLiter를 사용하여 저장된(소비되지 않음) 연료를 에너지로 변환하여 얻습니다.

uphillEfficiency와 페어링해야 합니다.

허용되는 값 범위는 0.0에서 1/uphillEfficiency입니다.

합리적인 값: 연소 모델의 경우: 0.51, 전기 모델의 경우 : 0.73
energyBudgetInkWh
 query

number

double

지정된 전기 소비 모델을 사용하여 주행할 수 있는 최대 범위를 결정하는 kWh(킬로와트시)의 전기 에너지 예산입니다.
energyBudgetInkWh를 사용하는 경우 자세한 전기 소비 모델을 지정해야 합니다.
정확히 하나의 예산(fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec 또는 distanceBudgetInMeters)을 사용해야 합니다.
fuelBudgetInLiters
 query

number

double

지정된 연소 소비 모델을 사용하여 주행할 수 있는 최대 범위를 결정하는 리터의 연료 예산입니다.
fuelBudgetInLiters를 사용하는 경우 자세한 연소 소비 모델을 지정해야 합니다.
정확히 하나의 예산(fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec 또는 distanceBudgetInMeters)을 사용해야 합니다.
fuelEnergyDensityInMJoulesPerLiter
 query

number

double

MJ(메가줄)의 1리터 연료에 저장된 화학 에너지의 양을 지정합니다. 저장되거나 소비된 에너지와 연료 간의 변환을 위한 *효율성 매개 변수와 함께 사용됩니다. 예를 들어 에너지 밀도는 가솔린의 경우 34.2MJ/l이고 디젤 연료의 경우 35.8MJ/l입니다.

*Efficiency 매개 변수가 설정된 경우 이 매개 변수가 필요합니다.

합리적인 값: 34.2
hilliness
 query

InclineLevel

스릴 넘치는 루트에 대한 언덕의 정도. 이 매개 변수는 =thrilling과 함께 routeType만 사용할 수 있습니다.
maxChargeInkWh
 query

number

double

차량의 배터리에 저장할 수 있는 최대 전기 에너지 공급량(kWh)을 지정합니다.

이 매개 변수는 currentChargeInkWh 매개 변수와 공존합니다.

최소값은 currentChargeInkWh보다 크거나 같아야 합니다.

합리적인 값: 85
routeType
 query

RouteType

요청된 경로의 유형입니다.
timeBudgetInSec
 query

number

double

운전 시간을 사용하여 여행할 수 있는 최대 범위를 결정하는 시간 예산(초)입니다. 소비 모델은 routeType이 에코인 경우에만 범위에 영향을 미칩니다.
정확히 하나의 예산(fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec 또는 distanceBudgetInMeters)을 사용해야 합니다.
traffic
 query

boolean

가능한 값은 다음과 같습니다.

  • true - 라우팅하는 동안 사용 가능한 모든 트래픽 정보를 고려하세요.
  • false - 라우팅하는 동안 현재 트래픽 데이터를 무시합니다. 라우팅 중에는 현재 트래픽 데이터가 무시되지만, 기록 트래픽이 효과적인 도로 속도에 미치는 영향은 여전히 통합되어 있습니다.
travelMode
 query

TravelMode

요청된 경로에 대한 이동 모드입니다. 정의되지 않은 경우 기본값은 'car'입니다. 요청된 travelMode를 전체 경로에 사용할 수 없습니다. 특정 섹션에 대해 요청된 travelMode를 사용할 수 없는 경우 해당 섹션에 대한 응답의 travelMode 요소는 "other"가 됩니다. 이동 모드 버스, 오토바이, 택시 및 밴은 BETA 기능입니다. 일부 영역에서는 전체 제한 데이터를 사용할 수 없습니다.
uphillEfficiency
 query

number

double

차량이 고도를 얻을 때 연료에 저장된 화학 에너지를 잠재적 에너지로 변환하는 효율성을 지정합니다 (예: PotentialEnergyGained/ChemicalEnergyConsumed). ChemicalEnergyConsumed 는 fuelEnergyDensityInMJoulesPerLiter를 사용하여 소비된 연료를 화학 에너지로 변환하여 얻습니다.

downhillEfficiency와 페어링해야 합니다.

허용되는 값 범위는 0.0에서 1/downhillEfficiency입니다.

합리적인 값: 연소 모델의 경우: 0.27, 전기 모델의 경우: 0.74
vehicleAxleWeight
 query

integer

차량의 차축당 무게(kg)입니다. 값이 0이면 액슬당 가중치 제한이 고려되지 않습니다.
vehicleCommercial
 query

boolean

차량이 상업적 목적으로 사용되는지 여부입니다. 상용차는 일부 도로에서 운전할 수 없습니다.
vehicleEngineType
 query

VehicleEngineType

차량의 엔진 유형입니다. 자세한 소비 모델을 지정하는 경우 vehicleEngineType 값과 일치해야 합니다.
vehicleHeight
 query

number

double

차량의 높이(미터)입니다. 값이 0이면 높이 제한이 고려되지 않습니다.
vehicleLength
 query

number

double

차량의 길이(미터)입니다. 값이 0이면 길이 제한이 고려되지 않습니다.
vehicleLoadType
 query

VehicleLoadType

위험 물질로 분류되고 일부 도로에서 제한될 수 있는 화물 유형입니다. 사용 가능한 vehicleLoadType 값은 미국 Hazmat 클래스 1~9와 다른 국가/지역에서 사용할 일반 분류입니다. USHazmat로 시작하는 값은 미국 라우팅을 위한 반면 otherHazmat는 다른 모든 국가/지역에 사용해야 합니다. vehicleLoadType을 여러 번 지정할 수 있습니다. 이 매개 변수는 현재 travelMode=truck에 대해서만 고려됩니다.
vehicleMaxSpeed
 query

integer

차량의 최대 속도(km/시간)입니다. 차량 프로필의 최대 속도는 고속도로에서 차량이 허용되는지 여부를 확인하는 데 사용됩니다.

  • 값이 0이면 경로 계획 중에 차량에 대한 적절한 값이 결정되고 적용됩니다.

  • 경로 계획 중에 0이 아닌 값이 재정의될 수 있습니다. 예를 들어 현재 트래픽 흐름은 시속 60km입니다. 차량 최대 속도가 시속 50km로 설정된 경우 라우팅 엔진은 현재 상황이므로 시속 60km를 고려합니다. 차량의 최대 속도는 시속 80km로 제공되지만 현재 교통 흐름은 시속 60km인 경우 라우팅 엔진은 시속 60km를 다시 사용합니다.
vehicleWeight
 query

integer

차량의 무게(킬로그램)입니다.

  • *효율성 매개 변수가 설정된 경우 필수입니다.

  • 소비 모델의 컨텍스트에서 사용할 때는 엄격히 긍정적이어야 합니다. 가중치 제한이 고려됩니다.

  • 자세한 소비 모델을 지정하지 않고 vehicleWeight 값이 0이 아닌 경우 가중치 제한이 고려됩니다.

  • 다른 모든 경우에는 이 매개 변수가 무시됩니다.

합리적인 값: 연소 모델의 경우: 1600, 전기 모델의 경우: 1900
vehicleWidth
 query

number

double

차량 너비(미터)입니다. 값이 0이면 너비 제한이 고려되지 않습니다.
windingness
 query

WindingnessLevel

스릴 넘치는 경로에 대한 회전의 수준. 이 매개 변수는 =thrilling과 함께 routeType만 사용할 수 있습니다.

요청 헤더

Name 필수 형식 Description
x-ms-client-id

string

Microsoft Entra ID 보안 모델과 함께 사용할 계정을 지정합니다. Azure Maps 계정에 대한 고유 ID를 나타내며 Azure Maps 관리 평면 계정 API에서 검색할 수 있습니다. Azure Maps에서 Microsoft Entra ID 보안을 사용하려면 지침은 다음 문서를 참조하세요.

응답

Name 형식 Description
200 OK

RouteRangeResult

정상
Other Status Codes

ErrorResponse

예기치 않은 오류가 발생했습니다.

보안

AADToken

다음은 Microsoft Entra OAuth 2.0 흐름입니다. Azure 역할 기반 액세스 제어와 페어링하면 Azure Maps REST API에 대한 액세스를 제어하는 데 사용할 수 있습니다. Azure 역할 기반 액세스 제어는 하나 이상의 Azure Maps 리소스 계정 또는 하위 리소스에 대한 액세스를 지정하는 데 사용됩니다. 모든 사용자, 그룹 또는 서비스 주체는 Azure Maps REST API에 대한 하나 이상의 권한으로 구성된 기본 제공 역할 또는 사용자 지정 역할을 통해 액세스 권한을 부여할 수 있습니다.

시나리오를 구현하려면 인증 개념을 보는 것이 좋습니다. 요약하자면, 이 보안 정의는 특정 API 및 범위에 대한 액세스 제어가 가능한 개체를 통해 애플리케이션을 모델링하기 위한 솔루션을 제공합니다.

참고

  • 이 보안 정의 에서는 헤더를 사용하여 애플리케이션이 x-ms-client-id 액세스를 요청하는 Azure Maps 리소스를 나타내야 합니다. 이는 Maps 관리 API에서 가져올 수 있습니다.

Authorization URL 은 Azure 퍼블릭 클라우드 인스턴스와 관련이 있습니다. 소버린 클라우드에는 고유한 권한 부여 URL 및 Microsoft Entra ID 구성이 있습니다. * Azure 역할 기반 액세스 제어는 Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면 에서 구성됩니다. * Azure Maps 웹 SDK 를 사용하면 여러 사용 사례에 대한 애플리케이션의 구성 기반 설정을 허용합니다.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
https://atlas.microsoft.com/.default https://atlas.microsoft.com/.default

subscription-key

Azure Portal에서 Azure Maps 계정을 만들 거나 PowerShell, CLI, Azure SDK 또는 REST API를 사용할 때 프로비전되는 공유 키입니다.

이 키를 사용하면 모든 애플리케이션이 모든 REST API에 액세스할 수 있습니다. 즉, 이 키를 발급된 계정에서 마스터 키로 사용할 수 있습니다.

공개적으로 노출된 애플리케이션의 경우 기밀 클라이언트 애플리케이션 접근 방식을 사용하여 키를 안전하게 저장할 수 있도록 Azure Maps REST API에 액세스하는 것이 좋습니다.

형식: apiKey
In(다음 안에): query

SAS Token

Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면을 통해 Azure Maps 리소스 의 SAS 나열 작업에서 생성된 공유 액세스 서명 토큰입니다.

이 토큰을 사용하면 모든 애플리케이션이 Azure 역할 기반 액세스 제어 및 특정 토큰에 사용할 만료, 속도 및 지역에 대한 세분화된 제어를 사용하여 액세스할 수 있는 권한이 부여됩니다. 즉, SAS 토큰을 사용하여 애플리케이션이 공유 키보다 더 보안이 유지되는 방식으로 액세스를 제어할 수 있습니다.

공개적으로 노출된 애플리케이션의 경우 렌더링 남용을 제한하고 정기적으로 SAS 토큰을 갱신하도록 Map 계정 리소스 에서 허용되는 특정 원본 목록을 구성하는 것이 좋습니다.

형식: apiKey
In(다음 안에): header

예제

Successfully retrieve a set of locations that can be reached from the origin point based on various conditions

샘플 요청

GET https://atlas.microsoft.com/route/range/json?api-version=1.0&query=50.97452,5.86605&timeBudgetInSec=6000

샘플 응답

상태 코드:
200 
{
  "formatVersion": "0.0.1",
  "reachableRange": {
    "center": {
      "latitude": 50.9745,
      "longitude": 5.86605
    },
    "boundary": [
      {
        "latitude": 52.03704,
        "longitude": 5.73602
      },
      {
        "latitude": 52.09456,
        "longitude": 5.59435
      },
      {
        "latitude": 52.16815,
        "longitude": 5.42279
      },
      {
        "latitude": 52.25047,
        "longitude": 5.21276
      },
      {
        "latitude": 52.21374,
        "longitude": 5.15355
      },
      {
        "latitude": 52.25674,
        "longitude": 4.96687
      },
      {
        "latitude": 52.07834,
        "longitude": 4.739
      },
      {
        "latitude": 52.05647,
        "longitude": 4.72513
      },
      {
        "latitude": 51.94553,
        "longitude": 4.53237
      },
      {
        "latitude": 51.70119,
        "longitude": 4.31165
      },
      {
        "latitude": 51.5837,
        "longitude": 4.28917
      },
      {
        "latitude": 51.48463,
        "longitude": 3.82685
      },
      {
        "latitude": 51.21096,
        "longitude": 3.62838
      },
      {
        "latitude": 50.6814,
        "longitude": 3.89244
      },
      {
        "latitude": 50.66791,
        "longitude": 3.93493
      },
      {
        "latitude": 50.49042,
        "longitude": 3.98156
      },
      {
        "latitude": 50.30944,
        "longitude": 4.47995
      },
      {
        "latitude": 50.24448,
        "longitude": 4.60502
      },
      {
        "latitude": 50.24467,
        "longitude": 4.89999
      },
      {
        "latitude": 50.08735,
        "longitude": 5.04206
      },
      {
        "latitude": 49.99214,
        "longitude": 5.23042
      },
      {
        "latitude": 49.88478,
        "longitude": 5.40994
      },
      {
        "latitude": 49.85797,
        "longitude": 5.46178
      },
      {
        "latitude": 49.86279,
        "longitude": 5.7196
      },
      {
        "latitude": 49.83259,
        "longitude": 5.74151
      },
      {
        "latitude": 50.22239,
        "longitude": 5.9387
      },
      {
        "latitude": 50.0011,
        "longitude": 6.08535
      },
      {
        "latitude": 50.04616,
        "longitude": 6.12089
      },
      {
        "latitude": 50.09472,
        "longitude": 6.28373
      },
      {
        "latitude": 49.95863,
        "longitude": 6.51654
      },
      {
        "latitude": 50.00485,
        "longitude": 6.61034
      },
      {
        "latitude": 50.00587,
        "longitude": 6.70295
      },
      {
        "latitude": 50.2947,
        "longitude": 6.65865
      },
      {
        "latitude": 50.36903,
        "longitude": 6.79276
      },
      {
        "latitude": 50.31614,
        "longitude": 7.32163
      },
      {
        "latitude": 50.36737,
        "longitude": 7.58782
      },
      {
        "latitude": 50.46919,
        "longitude": 7.7626
      },
      {
        "latitude": 50.96246,
        "longitude": 7.9826
      },
      {
        "latitude": 51.07086,
        "longitude": 7.55924
      },
      {
        "latitude": 51.36614,
        "longitude": 7.58138
      },
      {
        "latitude": 51.52015,
        "longitude": 7.67861
      },
      {
        "latitude": 51.65781,
        "longitude": 7.35175
      },
      {
        "latitude": 51.81916,
        "longitude": 7.21664
      },
      {
        "latitude": 51.9587,
        "longitude": 7.0467
      },
      {
        "latitude": 51.82713,
        "longitude": 6.67267
      },
      {
        "latitude": 51.81133,
        "longitude": 6.48424
      },
      {
        "latitude": 51.9368,
        "longitude": 6.27316
      },
      {
        "latitude": 52.01701,
        "longitude": 6.14452
      },
      {
        "latitude": 52.20847,
        "longitude": 6.09312
      },
      {
        "latitude": 52.23705,
        "longitude": 6.01297
      }
    ]
  }
}

정의

Name Description
EffectiveSetting

이 Route API를 호출할 때 사용되는 유효 매개 변수 또는 데이터입니다.
ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.
ErrorDetail

오류 세부 정보입니다.
ErrorResponse

오류 응답
InclineLevel

스릴 넘치는 경로에 대한 언덕의 정도. 이 매개 변수는 =thrilling과 routeType함께만 사용할 수 있습니다.
LatLongPair

위도 및 경도로 표시되는 위치입니다.
ResponseFormat

원하는 응답 형식입니다. 값은 json 또는 xml일 수 있습니다.
RouteAvoidType

경로를 결정할 때 경로 계산에서 피해야 하는 항목을 지정합니다. 한 요청에서 여러 번 지정할 수 있습니다. 예를 들어 'avoid=motorways &avoid=tollRoads&avoid=ferries'를&. 경로 범위 요청에서 이미UsedRoads 값을 사용하면 안 됩니다.
RouteRange

연결할 수 있는 범위
RouteRangeResult

이 개체는 경로 연결 가능 범위 호출에서 반환됩니다.
RouteReport

현재 호출에 사용된 유효 설정을 보고합니다.
RouteType

요청된 경로의 유형입니다.
TravelMode

요청된 경로의 이동 모드입니다. 정의되지 않은 경우 기본값은 'car'입니다. 요청된 travelMode를 전체 경로에 사용할 수 없습니다. 요청된 travelMode를 특정 섹션에 사용할 수 없는 경우 해당 섹션에 대한 응답의 travelMode 요소는 "other"가 됩니다. 여행 모드 버스, 오토바이, 택시 및 밴은 BETA 기능입니다. 일부 영역에서는 전체 제한 데이터를 사용할 수 없습니다.
VehicleEngineType

차량의 엔진 유형입니다. 자세한 소비 모델을 지정하는 경우 vehicleEngineType 값과 일치해야 합니다.
VehicleLoadType

위험 물질로 분류되고 일부 도로에서 제한될 수 있는 화물 유형입니다. 사용 가능한 vehicleLoadType 값은 미국 Hazmat 클래스 1~9와 다른 국가/지역에서 사용할 일반 분류입니다. USHazmat로 시작하는 값은 미국 라우팅에 사용되는 반면 otherHazmat는 다른 모든 국가/지역에 사용해야 합니다. vehicleLoadType을 여러 번 지정할 수 있습니다. 이 매개 변수는 현재 travelMode=truck에 대해서만 고려됩니다.
WindingnessLevel

스릴 넘치는 경로에 대한 회전의 수준. 이 매개 변수는 =thrilling과 routeType함께만 사용할 수 있습니다.

EffectiveSetting

이 Route API를 호출할 때 사용되는 유효 매개 변수 또는 데이터입니다.

Name 형식 Description
key

string

사용된 매개 변수의 이름입니다.
value

string

사용된 매개 변수의 값입니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name 형식 Description
info

object

추가 정보입니다.
type

string

추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.
code

string

오류 코드입니다.
details

ErrorDetail[]

오류 세부 정보입니다.
message

string

오류 메시지입니다.
target

string

오류 대상입니다.

ErrorResponse

오류 응답

Name 형식 Description
error

ErrorDetail

Error 개체.

InclineLevel

스릴 넘치는 경로에 대한 언덕의 정도. 이 매개 변수는 =thrilling과 routeType함께만 사용할 수 있습니다.

Name 형식 Description
high

string

high
low

string

low
normal

string

노멀

LatLongPair

위도 및 경도로 표시되는 위치입니다.

Name 형식 Description
latitude

number

위도 속성
longitude

number

경도 속성

ResponseFormat

원하는 응답 형식입니다. 값은 json 또는 xml일 수 있습니다.

Name 형식 Description
json

string

JavaScript 개체 표기법 데이터 교환 형식
xml

string

확장 가능한 태그 언어

RouteAvoidType

경로를 결정할 때 경로 계산에서 피해야 하는 항목을 지정합니다. 한 요청에서 여러 번 지정할 수 있습니다. 예를 들어 'avoid=motorways &avoid=tollRoads&avoid=ferries'를&. 경로 범위 요청에서 이미UsedRoads 값을 사용하면 안 됩니다.

Name 형식 Description
alreadyUsedRoads

string

동일한 도로를 여러 번 사용하지 않도록 합니다. =thrilling과 함께 routeType가장 유용합니다.
borderCrossings

string

경로 계산에서 테두리 교차를 방지합니다.
carpools

string

카풀(HOV/높은 점유율 차량) 차선을 사용해야 하는 경로를 방지합니다.
ferries

string

페리 방지
motorways

string

고속도로 방지
tollRoads

string

유료 도로를 방지합니다.
unpavedRoads

string

비포장 도로 방지

RouteRange

연결할 수 있는 범위

Name 형식 Description
boundary

LatLongPair[]

점 목록으로 표시되는 연결 가능한 범위의 다각형 경계입니다.
center

LatLongPair

연결할 수 있는 범위의 중심점

RouteRangeResult

이 개체는 경로 연결 가능 범위 호출에서 반환됩니다.

Name 형식 Description
formatVersion

string

Format Version 속성
reachableRange

RouteRange

연결할 수 있는 범위
report

RouteReport

현재 호출에 사용된 유효 설정을 보고합니다.

RouteReport

현재 호출에 사용된 유효 설정을 보고합니다.

Name 형식 Description
effectiveSettings

EffectiveSetting[]

이 Route API를 호출할 때 사용되는 유효 매개 변수 또는 데이터입니다.

RouteType

요청된 경로의 유형입니다.

Name 형식 Description
eco

string

경제와 속도에 따라 균형 잡힌 경로입니다.
fastest

string

가장 빠른 경로입니다.
shortest

string

거리별 최단 경로입니다.
thrilling

string

흥미롭거나 도전적인 도로를 포함하며 가능한 한 적은 수의 고속도로를 사용합니다. 포함된 턴의 수준과 언덕의 정도를 선택할 수 있습니다. 이를 설정하는 방법은 구불구불함 및 권면 매개 변수를 참조하세요. =스릴 넘치는 노선으로 계획된 routeType노선에는 900km의 제한이 있습니다.

TravelMode

요청된 경로의 이동 모드입니다. 정의되지 않은 경우 기본값은 'car'입니다. 요청된 travelMode를 전체 경로에 사용할 수 없습니다. 요청된 travelMode를 특정 섹션에 사용할 수 없는 경우 해당 섹션에 대한 응답의 travelMode 요소는 "other"가 됩니다. 여행 모드 버스, 오토바이, 택시 및 밴은 BETA 기능입니다. 일부 영역에서는 전체 제한 데이터를 사용할 수 없습니다.

Name 형식 Description
bus

string

반환된 경로는 버스 전용 차선 사용을 포함하여 버스에 최적화되어 있습니다. BETA 기능.
car

string

반환된 경로는 자동차에 최적화되어 있습니다.
motorcycle

string

반환된 경로는 오토바이에 최적화되어 있습니다. BETA 기능.
taxi

string

반환된 경로는 택시에 최적화되어 있습니다. BETA 기능.
truck

string

반환된 경로는 트럭과 같은 상용차에 최적화되어 있습니다.
van

string

반환된 경로는 밴에 최적화되어 있습니다. BETA 기능.

VehicleEngineType

차량의 엔진 유형입니다. 자세한 소비 모델을 지정하는 경우 vehicleEngineType 값과 일치해야 합니다.

Name 형식 Description
combustion

string

내연기관.
electric

string

전기 엔진.

VehicleLoadType

위험 물질로 분류되고 일부 도로에서 제한될 수 있는 화물 유형입니다. 사용 가능한 vehicleLoadType 값은 미국 Hazmat 클래스 1~9와 다른 국가/지역에서 사용할 일반 분류입니다. USHazmat로 시작하는 값은 미국 라우팅에 사용되는 반면 otherHazmat는 다른 모든 국가/지역에 사용해야 합니다. vehicleLoadType을 여러 번 지정할 수 있습니다. 이 매개 변수는 현재 travelMode=truck에 대해서만 고려됩니다.

Name 형식 Description
USHazmatClass1

string

폭발물
USHazmatClass2

string

압축 가스
USHazmatClass3

string

인화성 액체
USHazmatClass4

string

인화성 고체
USHazmatClass5

string

산화제
USHazmatClass6

string

독극물
USHazmatClass7

string

방사능
USHazmatClass8

string

부식성 물질
USHazmatClass9

string

기타
otherHazmatExplosive

string

폭발물
otherHazmatGeneral

string

기타
otherHazmatHarmfulToWater

string

물에 유해

WindingnessLevel

스릴 넘치는 경로에 대한 회전의 수준. 이 매개 변수는 =thrilling과 routeType함께만 사용할 수 있습니다.

Name 형식 Description
high

string

high
low

string

low
normal

string

노멀