Route - Get Route Range

서비스:: Maps

API 버전:: 1.0

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

비고

Azure Maps Route v1 서비스 사용 중지

Azure Maps Route v1 서비스는 이제 더 이상 사용되지 않으며 3/31/28에 사용 중지됩니다. 서비스 중단을 방지하려면 Route v1 서비스에 대한 모든 호출을 업데이트하여 3/31/28까지 Route v2025-01-01 서비스를 사용해야 합니다. 자세한 내용은 Azure Maps Route 1.0 API마이그레이션을 참조하세요.

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

반환된 다각형은 제공된 등시선 내에서 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) minimum: 0 maximum: 1	차량이 가속할 때 연료에 저장된 화학 에너지를 운동 에너지로 변환하는 효율성을 지정합니다(즉, KineticEnergyGained/ChemicalEnergyConsumed). ChemicalEnergyConsumedfuelEnergyDensityInMJoulesPerLiter사용하여 소비된 연료를 화학 에너지로 변환하여 얻습니다. 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 매개 변수와 공존합니다. 허용되는 값 범위는 maxChargeInkWh0.0입니다. 합리적인 값: 43
currentFuelInLiters	query		number (double)	리터에서 연료의 현재 공급을 지정합니다. 합리적인 값: 55
decelerationEfficiency	query		number (double) minimum: 0 maximum: 1	차량이 감속할 때 운동 에너지를 저장(소비되지 않음) 연료로 변환하는 효율성을 지정합니다(예: ChemicalEnergySaved/KineticEnergyLost). ChemicalEnergySavedfuelEnergyDensityInMJoulesPerLiter사용하여 저장된(소비되지 않음) 연료를 에너지로 변환하여 얻습니다. accelerationEfficiency쌍을 이겨야 합니다. 허용되는 값의 범위는 0.0에서 1/accelerationEfficiency. 합리적인 값 : 연소 모델 : 0.83, 전기 모델 : 0.91
departAt	query		string (date-time)	선택적 표준 시간대 오프셋이 있는 `dateTime`정의된 대로 값으로 서식이 지정된 원점에서 출발 날짜 및 시간입니다. 표준 시간대 오프셋을 지정하지 않으면 원점의 오프셋으로 간주됩니다. 기본값: now 기타 값: `dateTime` 예제: 2023-12-19T16:39:57 2023-12-19T16:39:57-08:00 `departAt` 매개 변수는 `arriveAt`함께 사용할 수 없습니다.
distanceBudgetInMeters	query		number (double)	주행 거리를 사용하여 주행할 수 있는 최대 범위를 결정하는 미터 단위의 거리 예산입니다. 소비 모델은 routeType이 에코인 경우에만 범위에 영향을 미칩니다. 정확히 하나의 예산(fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec 또는 distanceBudgetInMeters)을 사용해야 합니다.
downhillEfficiency	query		number (double) minimum: 0 maximum: 1	차량이 고도 손실될 때(즉, ChemicalEnergySaved/PotentialEnergyLost) 잠재적 에너지를 저장(소비되지 않음) 연료로 변환하는 효율성을 지정합니다. ChemicalEnergySavedfuelEnergyDensityInMJoulesPerLiter사용하여 저장된(소비되지 않음) 연료를 에너지로 변환하여 얻습니다. uphillEfficiency함께 사용해야 합니다. 허용되는 값의 범위는0.0~1/. 합리적인 값 : 연소 모델 : 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	스릴 넘치는 경로에 대한 언덕의 정도. 이 매개 변수는 `routeType`=thrilling과 함께만 사용할 수 있습니다.
maxChargeInkWh	query		number (double)	차량의 배터리에 저장할 수 있는 최대 전기 에너지 공급량(kWh)을 지정합니다. 이 매개 변수는 currentChargeInkWh 매개 변수와 공존합니다. 최소값은 현재ChargeInkWh보다 크거나 같아야 합니다. 합리적인 값: 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) minimum: 0 maximum: 1	차량이 상승 얻을 때 연료에 저장된 화학 에너지를 잠재적 에너지로 변환하는 효율성을 지정합니다(즉, PotentialEnergyGained/ChemicalEnergyConsumed). ChemicalEnergyConsumedfuelEnergyDensityInMJoulesPerLiter사용하여 소비된 연료를 화학 에너지로 변환하여 얻습니다. 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/hour)입니다. 차량 프로필의 최대 속도는 차량이 고속도로에서 허용되는지 여부를 확인하는 데 사용됩니다. 값이 0이면 경로 계획 중에 차량에 대한 적절한 값이 결정되고 적용됩니다. 경로 계획 중에 0이 아닌 값이 재정의될 수 있습니다. 예를 들어 현재 트래픽 흐름은 시속 60km입니다. 차량 최대 속도를 시속 50km로 설정하면 라우팅 엔진은 현재 상황이므로 60km/시속을 고려합니다. 차량의 최대 속도는 80km/시속으로 제공되지만 현재 교통 흐름은 시속 60km인 경우 라우팅 엔진은 시속 60km를 다시 사용합니다.
vehicleWeight	query		integer	차량의 무게(킬로그램)입니다. 효율성 매개 변수가 설정된 경우 필수입니다. 소비 모델의 컨텍스트에서 사용할 때는 반드시 양수여야 합니다. 가중치 제한이 고려됩니다. 자세한 소비 모델* 지정되지 않고 vehicleWeight 값이 0이 아닌 경우 가중치 제한이 고려됩니다. 다른 모든 경우에서 이 매개 변수는 무시됩니다. 합리적인 값 : 연소 모델 : 1600, 전기 모델 : 1900
vehicleWidth	query		number (double)	차량 너비(미터)입니다. 값이 0이면 너비 제한이 고려되지 않습니다.
windingness	query		WindingnessLevel	스릴 넘치는 경로에 대한 회전의 수준. 이 매개 변수는 `routeType`=thrilling과 함께만 사용할 수 있습니다.

요청 헤더

Name	필수	형식	Description
x-ms-client-id		string	Microsoft Entra ID 보안 모델과 함께 사용할 계정을 나타냅니다. Azure Maps 계정에 대한 이 고유 ID는 Azure Maps 관리 평면 계정 API에서 가져올 수 있습니다. Azure Maps에서 Microsoft Entra ID 보안을 사용하는 방법에 대한 자세한 내용은 Azure Maps에서 인증 관리를 참조하세요.

응답

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 Web SDK 사용하면 여러 사용 사례에 대한 애플리케이션의 구성 기반 설정을 사용할 수 있습니다.

Microsoft ID 플랫폼에 대한 자세한 내용은 Microsoft ID 플랫폼 개요참조하세요.

형식: 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 토큰을 갱신하도록 맵 계정 리소스 허용된 원본의 특정 목록을 구성하는 것이 좋습니다.

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

예제

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

샘플 요청

HTTP

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	스릴 넘치는 경로에 대한 언덕의 정도. 이 매개 변수는 `routeType`=thrilling과 함께만 사용할 수 있습니다.
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	스릴 넘치는 경로에 대한 회전의 수준. 이 매개 변수는 `routeType`=thrilling과 함께만 사용할 수 있습니다.

EffectiveSetting

Object

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

Name	형식	Description
key	string	사용된 매개 변수의 이름입니다.
value	string	사용된 매개 변수의 값입니다.

ErrorAdditionalInfo

Object

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

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

Object

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

Object

오류 응답

Name	형식	Description
error	ErrorDetail	오류 개체입니다.

InclineLevel

열거형

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

값	Description
low	낮다
normal	노멀
high	높다

LatLongPair

Object

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

Name	형식	Description
latitude	number (double)	위도 속성
longitude	number (double)	경도 속성

ResponseFormat

열거형

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

값	Description
json	JavaScript 개체 표기법 데이터 교환 형식
xml	확장 가능한 태그 언어

RouteAvoidType

열거형

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

값	Description
tollRoads	유료 도로를 방지합니다.
motorways	고속도로 방지
ferries	페리 방지
unpavedRoads	비포장 도로 방지
carpools	카풀(HOV/높은 점유 차량) 차선을 사용해야 하는 경로를 방지합니다.
alreadyUsedRoads	동일한 도로를 여러 번 사용하지 않습니다. `routeType`=thrilling과 함께 가장 유용합니다.
borderCrossings	경로 계산에서 테두리 횡단을 방지합니다.

RouteRange

Object

도달 가능한 범위

Name	형식	Description
boundary	LatLongPair[]	점 목록으로 표시되는 연결 가능한 범위의 다각형 경계입니다.
center	LatLongPair	연결 가능한 범위의 중심점

RouteRangeResult

Object

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

Name	형식	Description
formatVersion	string	Format Version 속성
reachableRange	RouteRange	도달 가능한 범위
report	RouteReport	현재 호출에 사용된 유효 설정을 보고합니다.

RouteReport

Object

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

Name	형식	Description
effectiveSettings	EffectiveSetting[]	이 Route API를 호출할 때 사용되는 유효 매개 변수 또는 데이터입니다.

RouteType

열거형

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

값	Description
fastest	가장 빠른 경로입니다.
shortest	거리별 최단 경로입니다.
eco	경제와 속도에 의해 균형 잡힌 경로입니다.
thrilling	흥미롭거나 까다로운 도로를 포함하며 가능한 한 적은 수의 고속도로를 사용합니다. 포함된 턴 수준과 구불구불한 정도를 선택할 수 있습니다. 이를 설정하는 방법은 구불구불한 구불구불한 구불구불한 매개 변수를 참조하세요. `routeType`=thrilling으로 계획된 경로에는 900km의 제한이 있습니다.

TravelMode

열거형

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

값	Description
car	반환된 경로는 자동차에 최적화되어 있습니다.
truck	반환된 경로는 트럭과 같은 상용 차량에 최적화되어 있습니다.
taxi	반환된 경로는 택시에 최적화되어 있습니다. BETA 기능.
bus	반환된 경로는 버스 전용 차선 사용을 포함하여 버스에 최적화되어 있습니다. BETA 기능.
van	반환된 경로는 밴에 최적화되어 있습니다. BETA 기능.
motorcycle	반환된 경로는 오토바이에 최적화되어 있습니다. BETA 기능.

VehicleEngineType

열거형

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

값	Description
combustion	내부 연소 엔진.
electric	전기 엔진.

VehicleLoadType

열거형

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

값	Description
USHazmatClass1	폭발물
USHazmatClass2	압축 가스
USHazmatClass3	인화성 액체
USHazmatClass4	인화성 고형물
USHazmatClass5	산화제
USHazmatClass6	독극물
USHazmatClass7	방사성
USHazmatClass8	부식성
USHazmatClass9	기타
otherHazmatExplosive	폭발물
otherHazmatGeneral	기타
otherHazmatHarmfulToWater	물에 유해

WindingnessLevel

열거형

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

값	Description
low	낮다
normal	노멀
high	높다

다음을 통해 공유

Route - Get Route Range

URI 매개 변수

요청 헤더

응답

보안

AADToken

비고

범위

subscription-key

SAS Token

예제

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

샘플 요청

샘플 응답

정의

EffectiveSetting

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

InclineLevel

LatLongPair

ResponseFormat

RouteAvoidType

RouteRange

RouteRangeResult

RouteReport

RouteType

TravelMode

VehicleEngineType

VehicleLoadType

WindingnessLevel