RouteGetRouteDirectionsQueryParamProperties interface

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

減速とペアリングする必要があります非効率性。

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

良識値 : 燃焼モデル : 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

プロパティ値

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

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

適切な値 : 0.2

auxiliaryPowerInLitersPerHour?: number

プロパティ値

ルートを決定するときに、ルートの計算で回避する必要がある何かを指定します。 1 つの要求で複数回指定できます。たとえば、'&avoid=高速道路&avoid=tollRoads&avoid=ferrys' です。 ルート範囲要求では、値 alreadyUsedRoads を使用しないでください。

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

プロパティ値

高速ヒューリスティック アルゴリズムを使用してルート ウェイポイントを順序変更し、ルートの長さを減らします。 routeType 最短のと組み合わせて使用すると、最適な結果が得られます。 配信元と目的地が最適化されたウェイポイント インデックスから除外されていることに注意してください。 応答に配信元と宛先を含めるには、すべてのインデックスを 1 ずつ増やして配信元を考慮し、最終的なインデックスとして宛先を追加してください。 指定できる値は true または false です。 True は可能であればより良い順序を計算しますが、0 より大きい maxAlternatives 値または円のウェイポイントと組み合わせて使用することはできません。 False は指定された順序で場所を使用し、routeRepresentation と組み合わせて使用することはできません 。

computeBestOrder?: boolean

プロパティ値

さまざまな種類の交通情報 (なし、履歴、ライブ) と既定の最適推定移動時間を使用して、追加の移動時間を返すかどうかを指定します。

computeTravelTimeFor?: "none" | "all"

プロパティ値

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

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

• 指定された速度がリスト内の 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 パラメーター 共に存在します。

使用できる値の範囲は、maxChargeInkWhを する 0.0 です。

適切な値 : 43

currentChargeInkWh?: number

プロパティ値

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

適切な値 : 55

currentFuelInLiters?: number

プロパティ値

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

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

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

良識値 : 燃焼モデル : 0.83, 電気モデル 用 : 0.91

decelerationEfficiency?: number

プロパティ値

dateTimeで定義されている 値として書式設定された出発地からの出発日時。タイム ゾーン オフセットは省略可能です。 タイム ゾーン オフセットが指定されていない場合は、原点のオフセットと見なされます。

• 既定値: 今すぐ
• その他の値: dateTime

例:

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

departAt パラメーターは、arriveAtと組み合わせて使用することはできません。

departAt?: string | Date

プロパティ値

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

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

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

良識値 : 燃焼モデル : 0.51, 電気モデル 用 : 0.73

downhillEfficiency?: number

プロパティ値

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

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

適切な値 : 34.2

fuelEnergyDensityInMJoulesPerLiter?: number

プロパティ値

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

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

プロパティ値

指定した場合は、ガイダンスの指示が返されます。 instructionsType パラメーターを routeRepresentation=none と組み合わせて使用することはできません。

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

プロパティ値

language パラメーターは、ガイダンス メッセージの言語を決定します。 固有名詞 (道路、広場などの名前) は、指定された言語で返されます。または、使用できない場合は、それに近い使用可能な言語で返されます。 使用できる値は、IETF 言語タグのサブセットです。 現在サポートされている言語は、「サポートされている言語の 」セクションに記載されています。

既定値: en-GB

language?: string

プロパティ値

計算する必要がある代替ルートの数。 既定値: 0、最小: 0、最大: 5

maxAlternatives?: number

プロパティ値

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

このパラメーターは、currentChargeInkWh パラメーター 共に存在します。

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

賢明な値 : 85

maxChargeInkWh?: number

プロパティ値

返されるすべての代替ルートは、少なくともこのメーター数の calculateRoute 要求の起点からの参照ルート (POST 要求のセクションを参照) に従います。 ルートを再構築する場合にのみ使用できます。 minDeviationDistance パラメーターを arriveAt と組み合わせて使用することはできません

minDeviationDistance?: number

プロパティ値

返されるすべての代替ルートは、calculateRoute 要求の起点からの参照ルート (POST 要求のセクションを参照) に従って、少なくともこの秒数続きます。 ルートを再構築する場合にのみ使用できます。 minDeviationTime パラメーターは、arriveAt と組み合わせて使用することはできません。 既定値は 0 です。 )minDeviationTime_を 0 より大きい値に設定すると、次のような結果になります。

• calculateRoute 要求の起点は、入力参照ルート上にある (または非常に近い) 必要があります。
  • そうでない場合は、エラーが返されます。
  • ただし、起点は入力参照ルートの先頭にある必要はありません (基準ルート上の現在の車両位置と考えることができます)。
• calculateRoute Response の最初のルートとして返される参照ルートは、calculateRoute 要求で指定された起点から開始されます。 起点が応答から除外されるまでの入力参照ルートの最初の部分。
• minDeviationDistance と minDeviationTime 値によって、代替ルートが起点から基準ルートにどの程度確実に従うのかを決定。
• ルートでは、を使用する必要があります。
• vehicleHeading は無視されます。

minDeviationTime?: number

プロパティ値

ルートの計算に使用する座標をコロンで区切ります。 少なくとも 2 つの座標が必要です。 最初の 1 つは出発地で、最後はルートの宛先です。 中間のオプションの座標は、ルート内の WayPoint として機能します。 最大 150 個の WayPoint を渡すことができます。

query: string

プロパティ値

診断のために報告するデータを指定します。 有効な値は effectiveSettingsだけです。 API を呼び出すときに使用される有効なパラメーターまたはデータを報告します。 既定のパラメーターの場合、パラメーターが呼び出し元によって指定されなかった場合、既定値が反映されます。

report?: "effectiveSettings"

プロパティ値

応答として提供される一連のルートの表現を指定します。

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

プロパティ値

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

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

プロパティ値

ルート応答で報告されるセクションの種類を指定します。

たとえば、sectionType = 歩行者の場合、歩行者のみに適したセクションが返されます。 '§ionType=carTrain§ionType=歩行者§ionType=高速道路' など、1 つの要求で複数回指定できます。 既定の sectionType は travelMode 入力を参照します。 既定では、travelMode は car に設定されています

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

プロパティ値

使用可能な値:

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

traffic?: boolean

プロパティ値

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

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 度、東は 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/時間での車両の最高速度。 車両プロファイルの最大速度は、高速道路で車両が許可されているかどうかを確認するために使用されます。

• 値が 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

プロパティ値

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

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

プロパティ値