RouteGetRouteDirectionsQueryParamProperties interface

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

decelerationEfficiency함께 사용해야 합니다.

허용되는 값의 범위는 0.0에서 1/decelerationEfficiency.

합리적인 값 : 연소 모델 : 0.33, 전기 모델 : 0.66

accelerationEfficiency?: number

속성 값

참조 경로에 비해 계산된 대안의 지정된 계획 기준에 따라 최적도를 제어합니다.

alternativeType?: "anyRoute" | "betterRoute"

속성 값

선택적 표준 시간대 오프셋이 있는 dateTime정의된 대로 값으로 서식이 지정된 대상 지점의 도착 날짜 및 시간입니다. 표준 시간대 오프셋을 지정하지 않으면 대상 지점의 오프셋으로 간주됩니다.

예:

• 2023-12-19T16:39:57
• 2023-12-19T16:39:57-08:00

arriveAt 매개 변수는 departAt, minDeviationDistance 또는 minDeviationTime함께 사용할 수 없습니다.

arriveAt?: string | Date

속성 값

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

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

합리적인 값: 1.7

auxiliaryPowerInkW?: number

속성 값

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

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

합리적인 값: 0.2

auxiliaryPowerInLitersPerHour?: number

속성 값

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

avoid?: ("tollRoads" | "motorways" | "ferries" | "unpavedRoads" | "carpools" | "alreadyUsedRoads" | "borderCrossings")[]

속성 값

경로 길이를 줄이기 위해 빠른 추론 알고리즘을 사용하여 경로 웨이포인트의 순서를 다시 지정합니다. routeType 가장 짧은함께 사용할 때 최상의 결과를 생성합니다. 원본 및 대상은 최적화된 웨이포인트 인덱스에서 제외됩니다. 응답에 원본 및 대상을 포함하려면 원본을 고려하여 모든 인덱스를 1씩 늘인 다음 대상을 최종 인덱스로 추가하세요. 가능한 값은 true 또는 false입니다. True는 가능한 경우 더 나은 순서를 계산하지만 0보다 큰 maxAlternatives 값과 함께 사용하거나 원 웨이포인트와 함께 사용할 수 없습니다. False는 지정된 순서로 위치를 사용하며 routeRepresentation과 함께 사용할 수 없습니다.

computeBestOrder?: boolean

속성 값

다양한 유형의 교통 정보(없음, 기록, 라이브)와 기본 최적 예상 이동 시간을 사용하여 추가 이동 시간을 반환할지 여부를 지정합니다.

computeTravelTimeFor?: "none" | "all"

속성 값

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

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

• 선형 보간을 통해 지정된 속도가 목록의 두 속도 사이에 있는 경우

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

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

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

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

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

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

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

constantSpeedConsumptionInkWhPerHundredkm?: string

속성 값

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

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

• 선형 보간을 통해 지정된 속도가 목록의 두 속도 사이에 있는 경우

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

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

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

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

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

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

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

constantSpeedConsumptionInLitersPerHundredkm?: string

속성 값

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

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

허용되는 값 범위는 maxChargeInkWh0.0입니다.

합리적인 값: 43

currentChargeInkWh?: number

속성 값

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

합리적인 값: 55

currentFuelInLiters?: number

속성 값

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

accelerationEfficiency쌍을 이겨야 합니다.

허용되는 값의 범위는 0.0에서 1/accelerationEfficiency.

합리적인 값 : 연소 모델 : 0.83, 전기 모델 : 0.91

decelerationEfficiency?: number

속성 값

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

• 기본값: now
• 기타 값: dateTime

예:

• 2023-12-19T16:39:57
• 2023-12-19T16:39:57-08:00

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

departAt?: string | Date

속성 값

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

uphillEfficiency함께 사용해야 합니다.

허용되는 값의 범위는0.0~1/.

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

downhillEfficiency?: number

속성 값

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

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

합리적인 값: 34.2

fuelEnergyDensityInMJoulesPerLiter?: number

속성 값

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

hilliness?: "low" | "normal" | "high"

속성 값

지정한 경우 지침 지침이 반환됩니다. instructionsType 매개 변수는 routeRepresentation=none과 함께 사용할 수 없습니다.

instructionsType?: "coded" | "text" | "tagged"

속성 값

언어 매개 변수는 지침 메시지의 언어를 결정합니다. 적절한 명사(거리, 광장 등의 이름)는 지정된 언어로 반환되거나, 사용할 수 없는 경우 가까운 사용 가능한 언어로 반환됩니다. 허용되는 값은 IETF 언어 태그의 하위 집합입니다. 현재 지원되는 언어는지원되는 언어 섹션에 나열됩니다.

기본값: en-GB

language?: string

속성 값

계산할 원하는 대체 경로 수입니다. 기본값: 0, 최소: 0 및 최대: 5

maxAlternatives?: number

속성 값

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

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

최소값은 현재ChargeInkWh보다 크거나 같아야 합니다.

합리적인 값: 85

maxChargeInkWh?: number

속성 값

반환되는 모든 대체 경로는 적어도 이 미터 수에 대한 calculateRoute 요청의 원본 지점에서 참조 경로(POST 요청 섹션 참조)를 따릅니다. 경로를 다시 구성할 때만 사용할 수 있습니다. minDeviationDistance 매개 변수는 arriveAt와 함께 사용할 수 없습니다.

minDeviationDistance?: number

속성 값

반환되는 모든 대체 경로는 calculateRoute 요청의 원본 지점에서 최소 이 시간(초)의 참조 경로(POST 요청 섹션 참조)를 따릅니다. 경로를 다시 구성할 때만 사용할 수 있습니다. minDeviationTime 매개 변수는 arriveAt와 함께 사용할 수 없습니다. 기본값은 0입니다. )minDeviationTime_ 0보다 큰 값으로 설정하면 다음과 같은 결과가 나타납니다.

• calculateRoute 요청의 원본 지점은 입력 참조 경로에 있거나 매우 가깝습니다.
  • 그렇지 않으면 오류가 반환됩니다.
  • 그러나 원점은 입력 참조 경로의 시작 부분에 있을 필요가 없습니다(참조 경로의 현재 차량 위치로 생각할 수 있습니다).
• calculateRoute Response의 첫 번째 경로로 반환되는 참조 경로는 calculateRoute 요청에 지정된 원본 지점에서 시작됩니다. 원본 지점이 응답에서 제외될 때까지 입력 참조 경로의 초기 부분입니다.
• minDeviationDistance 및 minDeviationTime 값은 대체 경로가 원점부터 참조 경로를 따라가도록 보장되는 정도를 결정할 있습니다.
• 경로는 사용해야 합니다..
• 차량 헤드링 무시됩니다.

minDeviationTime?: number

속성 값

경로가 계산되는 좌표이며 콜론으로 구분됩니다. 최소 2개의 좌표가 필요합니다. 첫 번째는 출발지이고 마지막은 경로의 대상입니다. 선택적 좌표 사이의 좌표는 경로에서 WayPoints로 작동합니다. 최대 150개의 WayPoint를 전달할 수 있습니다.

query: string

속성 값

진단을 위해 보고해야 하는 데이터를 지정합니다. 유일한 가능한 값은 effectiveSettings. API를 호출할 때 사용되는 유효 매개 변수 또는 데이터를 보고합니다. 기본 매개 변수의 경우 기본값은 호출자가 매개 변수를 지정하지 않은 위치에 반영됩니다.

report?: "effectiveSettings"

속성 값

응답으로 제공된 경로 집합의 표현을 지정합니다.

routeRepresentation?: "polyline" | "summaryOnly" | "none"

속성 값

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

routeType?: "fastest" | "shortest" | "eco" | "thrilling"

속성 값

경로 응답에서 보고되는 섹션 유형을 지정합니다.

예를 들어 sectionType = 보행자에 적합한 구역만 반환됩니다. 한 요청에서 여러 번 지정할 수 있습니다(예: '§ionType=carTrain§ionType=pedestrian§ionType=motorway'). 기본 sectionType은 travelMode 입력을 참조합니다. 기본적으로 travelMode는 자동차로 설정됩니다.

sectionType?: ("carTrain" | "country" | "ferry" | "motorway" | "pedestrian" | "tollRoad" | "tollVignette" | "traffic" | "travelMode" | "tunnel" | "carpool" | "urban")[]

속성 값

가능한 값:

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

traffic?: boolean

속성 값

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

travelMode?: "pedestrian" | "car" | "truck" | "taxi" | "bus" | "van" | "motorcycle" | "bicycle"

속성 값

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

downhillEfficiency함께 사용해야 합니다.

허용되는 값의 범위는 0.0에서 1/downhillEfficiency.

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

uphillEfficiency?: number

속성 값

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

vehicleAxleWeight?: number

속성 값

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

vehicleCommercial?: boolean

속성 값

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

vehicleEngineType?: "combustion" | "electric"

속성 값

실제 북쪽에서 시작하여 시계 방향으로 계속되는 차량의 방향 방향입니다. 북쪽은 0도, 동쪽은 90도, 남쪽은 180도, 서쪽은 270도입니다. 가능한 값 0-359

vehicleHeading?: number

속성 값

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

vehicleHeight?: number

속성 값

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

vehicleLength?: number

속성 값

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

vehicleLoadType?: "USHazmatClass1" | "USHazmatClass2" | "USHazmatClass3" | "USHazmatClass4" | "USHazmatClass5" | "USHazmatClass6" | "USHazmatClass7" | "USHazmatClass8" | "USHazmatClass9" | "otherHazmatExplosive" | "otherHazmatGeneral" | "otherHazmatHarmfulToWater"

속성 값

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

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

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

vehicleMaxSpeed?: number

속성 값

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

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

• 소비 모델의 컨텍스트에서 사용할 때는 반드시 양수여야 합니다. 가중치 제한이 고려됩니다.

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

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

합리적인 값 : 연소 모델 : 1600, 전기 모델 : 1900

vehicleWeight?: number

속성 값

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

vehicleWidth?: number

속성 값

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

windingness?: "low" | "normal" | "high"

속성 값