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 를 사용하면 여러 사용 사례에 대한 애플리케이션의 구성 기반 설정을 허용합니다.

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 토큰을 갱신하도록 Map 계정 리소스 에서 허용되는 특정 원본 목록을 구성하는 것이 좋습니다.

형식: 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	스릴 넘치는 경로에 대한 언덕의 정도. 이 매개 변수는 =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	노멀

다음을 통해 공유