RouteGetRouteRangeQueryParamProperties interface

車両が加速したときに燃料に格納されている化学エネルギーを運動エネルギーに変換する効率を指定します (例: KineticEnergyGained/ChemicalEnergyConsumed)。ChemicalEnergyConsumed は、 fuelEnergyDensityInMJoulesPerLiter を使用して、消費された燃料を化学エネルギーに変換することによって得られます。

減速効率と組み合わせて使用 する必要があります。

使用できる値の範囲は、0.0 から 1/減速効率です。

良識値 : 燃焼モデル の場合 : 0.33, 電気モデル : 0.66

accelerationEfficiency?: number

プロパティ値

補助システムを維持するために消費される電力の量をキロワット (kW) 単位で指定します。

ACシステム、無線、暖房などのデバイスやシステムによる消費を指定するために使用できます。

賢明な値: 1.7

auxiliaryPowerInkW?: number

プロパティ値

車両の補助システムを維持するために消費される燃料の量を 1 時間あたりのリットル単位で指定します。

ACシステム、無線、暖房などのデバイスやシステムによる消費を指定するために使用できます。

賢明な値: 0.2

auxiliaryPowerInLitersPerHour?: number

プロパティ値

ルートの決定時にルート計算で回避する必要のあるものを指定します。 "&avoid=motorways&avoid=tollRoads&avoid=ferrys" など、1 つの要求で複数回指定できます。 calculateReachableRange 要求では、既にUsedRoads の値を使用しないでください。

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

プロパティ値

消費の速度に依存するコンポーネントを指定します。

速度と消費レートのペアの順序なしのリストとして提供されます。 この一覧では、消費曲線上のポイントを定義します。 一覧にない速度の従量課金レートは次のとおりです。

• 線形補間によって、指定された速度がリスト内の 2 つの速度の間にある場合

• それ以外の場合は線形外挿によって、リスト内の最も近い 2 つのポイントによって決定される定数 (ΔConsumption/ΔSpeed) を想定します

リストには 1 ~ 25 ポイント (両端を含む) が含まれている必要があり、同じ速度の重複するポイントが含まれていない可能性があります。 1 つのポイントのみが含まれている場合は、そのポイントの消費率がそれ以上処理されずに使用されます。

最大速度に対して指定される消費量は、最後の最大速度以上である必要があります。 これにより、外挿によって消費率がマイナスにならないことが保証されます。

同様に、一覧の 2 つの最小速度に対して指定された従量課金の値は、速度が小さい場合に負の消費率を招くことはできません。

消費値 (kWh/100km で表される) の有効な範囲は、0.01 から 100000.0 の間です。

賢明な値: 50,8.2:130,21.3

このパラメーターは、 電力消費モデルに必要です。

constantSpeedConsumptionInkWhPerHundredkm?: string

プロパティ値

消費の速度に依存するコンポーネントを指定します。

コロンで区切られた速度 & 従量課金制ペアの順序なしのリストとして提供されます。 この一覧では、消費曲線上のポイントを定義します。 一覧にない速度の従量課金レートは次のとおりです。

• 線形補間によって、指定された速度がリスト内の 2 つの速度の間にある場合

• それ以外の場合は線形外挿によって、リスト内の最も近い 2 つのポイントによって決定される定数 (ΔConsumption/ΔSpeed) を想定します

リストには 1 ~ 25 ポイント (両端を含む) が含まれている必要があり、同じ速度の重複するポイントが含まれていない可能性があります。 1 つのポイントのみが含まれている場合は、そのポイントの消費率がそれ以上処理されずに使用されます。

最大速度に対して指定される消費量は、最後の最大速度以上である必要があります。 これにより、外挿によって消費率がマイナスにならないことが保証されます。

同様に、一覧内の 2 つの最小速度に対して指定された消費量の値は、より小さい速度の負の消費率につながることはできません。

消費値 (l/100km で表される) の有効な範囲は 0.01 ~ 100000.0 です。

適切な値: 50,6.3:130,11.5

注 : このパラメータは 、燃焼消費モデルに必要です。

constantSpeedConsumptionInLitersPerHundredkm?: string

プロパティ値

現在の電力供給量をキロワット時 (kWh) で指定します。

このパラメーターは maxChargeInkWh パラメーターと共存します。

使用できる値の範囲は 0.0 から maxChargeInkWh です。

賢明な値 : 43

currentChargeInkWh?: number

プロパティ値

燃料の現在の供給量をリットル単位で指定します。

賢明な値 : 55

currentFuelInLiters?: number

プロパティ値

車両が減速したときに、運動エネルギーを節約 (消費されていない) 燃料に変換する効率を指定します (つまり、ChemicalEnergySaved/KineticEnergyLost)。ChemicalEnergySaved は、 fuelEnergyDensityInMJoulesPerLiter を使用して、保存された (消費されていない) 燃料をエネルギーに変換することによって取得されます。

accelerationEfficiency とペアにする必要があります。

使用できる値の範囲は、0.0 ~ 1/accelerationEfficiency です。

良識値 : 燃焼モデル の場合 : 0.83, 電気モデル の場合 : 0.91

decelerationEfficiency?: number

プロパティ値

出発地点からの出発日時。 現在とは別の出発時刻は dateTime として指定する必要があります。 タイム ゾーン オフセットが指定されていない場合は、原点のオフセットと見なされます。 departAt 値は、将来の日付/時刻形式 (1996-12-19T16:39:57-08:00) である必要があります。

departAt?: string | Date

プロパティ値

走行距離を使用して移動できる最大範囲を決定する距離予算 (メートル単位)。 従量課金モデルは、routeType が eco の場合にのみ範囲に影響します。
1 つの予算 (fuelBudgetInLiters、energyBudgetInkWh、timeBudgetInSec、または distanceBudgetInMeters) を使用する必要があります。

distanceBudgetInMeters?: number

プロパティ値

車両が標高を失ったときに、潜在的なエネルギーを節約 (消費されていない) 燃料に変換する効率を指定します (つまり、ChemicalEnergySaved/PotentialEnergyLost)。ChemicalEnergySaved は、 fuelEnergyDensityInMJoulesPerLiter を使用して、保存された (消費されていない) 燃料をエネルギーに変換することによって取得されます。

uphillEfficiency とペアにする必要があります。

使用できる値の範囲は 0.0 ~ 1/uphillEfficiency です。

良識値 : 燃焼モデル の場合 : 0.51, 電気モデル の場合 : 0.73

downhillEfficiency?: number

プロパティ値

指定された電力消費モデルを使用して走行できる最大範囲を決定するキロワット時間 (kWh) の電力エネルギー予算。
energyBudgetInkWh を使用する場合は、詳細な電力消費モデルを指定する必要があります。
1 つの予算 (fuelBudgetInLiters、energyBudgetInkWh、timeBudgetInSec、または distanceBudgetInMeters) を使用する必要があります。

energyBudgetInkWh?: number

プロパティ値

指定された燃焼消費モデルを使用して走行可能な最大範囲を決定するリットル単位の燃料予算。
fuelBudgetInLiters を使用する場合は、詳細な燃焼消費モデルを指定する必要があります。
1 つの予算 (fuelBudgetInLiters、energyBudgetInkWh、timeBudgetInSec、または distanceBudgetInMeters) を使用する必要があります。

fuelBudgetInLiters?: number

プロパティ値

メガジュール (MJ) の 1 リットルの燃料に格納される化学エネルギーの量を指定します。 これは、保存または消費されたエネルギーと燃料の間の変換のために*効率 パラメータと組み合わせて使用されます。 たとえば、ガソリンのエネルギー密度は 34.2 MJ/l、ディーゼル燃料の場合は 35.8 MJ/l です。

*Efficiency パラメーターが設定されている場合は、このパラメーターが必要です。

賢明な値 : 34.2

fuelEnergyDensityInMJoulesPerLiter?: number

プロパティ値

スリル満点のルートのための丘陵性の程度。 このパラメーターは、=thrilling と routeType組み合わせてのみ使用できます。

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

プロパティ値

車両のバッテリーに格納できる最大電力供給量をキロワット時 (kWh) 単位で指定します。

このパラメーターは currentChargeInkWh パラメーターと共存します。

最小値は currentChargeInkWh 以上である必要があります。

賢明な値 : 85

maxChargeInkWh?: number

プロパティ値

範囲の計算を開始する座標。

query: number[]

プロパティ値

要求されたルートの種類。

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

プロパティ値

運転時間を使用して移動できる最大範囲を決定する時間予算 (秒)。 従量課金モデルは、routeType が eco の場合にのみ範囲に影響します。
1 つの予算 (fuelBudgetInLiters、energyBudgetInkWh、timeBudgetInSec、または distanceBudgetInMeters) を使用する必要があります。

timeBudgetInSec?: number

プロパティ値

指定できる値

• true - ルーティング中に使用可能なすべてのトラフィック情報を考慮する
• false - ルーティング中に現在のトラフィック データを無視します。 現在のトラフィック データはルーティング中は無視されますが、有効な道路速度に対する履歴トラフィックの影響は引き続き組み込まれることに注意してください。

traffic?: boolean

プロパティ値

要求されたルートの移動モード。 定義されていない場合、既定値は 'car' です。 要求された travelMode は、ルート全体で使用できない場合があることに注意してください。 要求された travelMode が特定のセクションで使用できない場合、そのセクションの応答の travelMode 要素は "other" になります。 移動モードバス、オートバイ、タクシー、バンはベータ機能であることに注意してください。 すべての領域で完全な制限データを使用できるわけではありません。 ReachableRange 要求の計算では、自転車と歩行者の値を使用しないでください。

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

プロパティ値

車両が昇格したときに、燃料に格納されている化学エネルギーを潜在的なエネルギーに変換する効率を指定します (つまり、PotentialEnergyGained/ChemicalEnergyConsumed)。ChemicalEnergyConsumed は、使用した燃料を fuelEnergyDensityInMJoulesPerLiter を使用して化学エネルギーに変換することによって得られます。

ダウンヒル効率性とペアにする必要があります。

使用できる値の範囲は、0.0 から 1/ダウンヒル効率です。

良識値 : 燃焼モデル の場合 : 0.27, 電気モデル の場合 : 0.74

uphillEfficiency?: number

プロパティ値

車両の車軸あたりの重量 (kg)。 値が 0 の場合、車軸あたりの重量制限は考慮されません。

vehicleAxleWeight?: number

プロパティ値

車両が商用目的で使用されているかどうか。 一部の道路では商用車の運転が許可されない場合があります。

vehicleCommercial?: boolean

プロパティ値

車両のエンジンタイプ。 詳細な従量課金モデルを指定する場合は、 vehicleEngineType の値と一致している必要があります。

vehicleEngineType?: "combustion" | "electric"

プロパティ値

車両の高さ (メートル単位)。 値が 0 の場合、高さの制限は考慮されません。

vehicleHeight?: number

プロパティ値

車両の長さ (メートル単位)。 値 0 は、長さの制限が考慮されないことを意味します。

vehicleLength?: number

プロパティ値

危険物として分類され、一部の道路から制限される可能性のある貨物の種類。 使用可能な vehicleLoadType 値は、US Hazmat クラス 1 から 9 に加えて、他の国で使用するための一般的な分類です。 USHazmat で始まる値は米国のルーティング用であり、otherHazmat は他のすべての国で使用する必要があります。 vehicleLoadType は複数回指定できます。 このパラメーターは現在、travelMode=truck でのみ考慮されています。

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

プロパティ値

キロ/時の車両の最高速度。 車両プロファイルの最大速度は、高速道路で車両が許可されているかどうかをチェックするために使用されます。

• 値 0 は、ルート計画中に車両に適切な値が決定され、適用されることを意味します。

• 0 以外の値は、ルート計画中にオーバーライドされる可能性があります。 たとえば、現在のトラフィック フローは 60 km/時です。 車両の最高速度が 50 km/時に設定されている場合、現在の状況であるため、ルーティング エンジンは 60 km/時を考慮します。 車両の最高速度が 80 km/時として提供されているが、現在の交通フローが 60 km/時である場合、ルーティング エンジンは再び 60 km/時を使用します。

vehicleMaxSpeed?: number

プロパティ値

車両の重量 (キロ単位)。

• *効率パラメーターのいずれかが設定されている場合は必須です。

• 従量課金モデルのコンテキストで使用する場合は、厳密に正である必要があります。 重みの制限が考慮されます。

• 詳細な 従量課金モデル が指定されておらず、 vehicleWeight の値が 0 以外の場合は、重量制限が考慮されます。

• それ以外の場合は、このパラメーターは無視されます。

良識値 : 燃焼モデル の場合 : 1600, 電気モデル : 1900

vehicleWeight?: number

プロパティ値

車両の幅 (メートル単位)。 値が 0 の場合、幅の制限は考慮されません。

vehicleWidth?: number

プロパティ値

スリル満点のルートのターンのレベル。 このパラメーターは、=thrilling と routeType組み合わせてのみ使用できます。

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

プロパティ値