RouteGetRouteRangeQueryParamProperties interface

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

decelerationEfficiency함께 사용해야 합니다.

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

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

accelerationEfficiency?: number

속성 값

보조 시스템을 유지하는 데 사용되는 전력의 양을 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")[]

속성 값

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

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

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

• 그렇지 않으면 선형 외삽으로, 목록에서 가장 가까운 두 점으로 결정되는 상수(Δ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

속성 값

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

distanceBudgetInMeters?: number

속성 값

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

uphillEfficiency함께 사용해야 합니다.

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

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

downhillEfficiency?: number

속성 값

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

energyBudgetInkWh?: number

속성 값

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

fuelBudgetInLiters?: number

속성 값

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

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

합리적인 값: 34.2

fuelEnergyDensityInMJoulesPerLiter?: number

속성 값

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

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

속성 값

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

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

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

합리적인 값: 85

maxChargeInkWh?: number

속성 값

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

query: number[]

속성 값

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

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

속성 값

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

timeBudgetInSec?: number

속성 값

가능한 값:

• 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이면 높이 제한이 고려되지 않습니다.

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"

속성 값