RouteGetRouteDirectionsQueryParamProperties interface

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

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

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

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

accelerationEfficiency?: number

プロパティ値

指定された計画基準に関して、参照ルートと比較して計算された代替の最適性を制御します。

alternativeType?: "anyRoute" | "betterRoute"

プロパティ値

目的地への到着日時。 dateTime として指定する必要があります。 タイム ゾーン オフセットが指定されていない場合は、ターゲット ポイントのオフセットと見なされます。 arriveAt 値は将来である必要があります。 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' です。 CalculateReachableRange 要求では、既にUsedRoads の値を使用しないでください。

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

プロパティ値

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

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 パラメーターと共存します。

使用できる値の範囲は 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

プロパティ値

車両が標高を失ったときに、潜在的なエネルギーを節約 (消費されていない) 燃料に変換する効率を指定します (つまり、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

プロパティ値

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

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 応答の最初のルートとして返される参照ルートは、calculateRoute 要求で指定された原点から開始されます。 原点が応答から除外されるまでの入力参照ルートの最初の部分。
• minDeviationDistance と minDeviationTime の値によって、基準点以降の参照ルートに従うことを保証する代替ルートの距離が決まります。
• ルートでは 、departAt を使用する必要があります。
• vehicleHeading は無視されます。

minDeviationTime?: number

プロパティ値

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

query: string

プロパティ値

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

report?: "effectiveSettings"

プロパティ値

応答として提供されるルートのセットの表現を指定します。 このパラメーター値は、computeBestOrder=true と組み合わせてのみ使用できます。

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

プロパティ値

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

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

プロパティ値

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

たとえば、sectionType = 歩行者の場合、歩行者のみに適したセクションが返されます。 複数の型を使用できます。 既定の 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" になります。 移動モードバス、オートバイ、タクシー、バンはベータ機能であることに注意してください。 すべての領域で完全な制限データを使用できるわけではありません。 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 度、東は 90 度、南は 180 度、西は 270 度です。 使用可能な値 0 から 359

vehicleHeading?: number

プロパティ値

車両の高さ (メートル単位)。 値が 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"

プロパティ値

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

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

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

vehicleMaxSpeed?: number

プロパティ値

車両の重量 (kg 単位)。

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

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

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

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

賢明な値 : 燃焼モデル の場合 : 1600, 電気モデル : 1900

vehicleWeight?: number

プロパティ値

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

vehicleWidth?: number

プロパティ値

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

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

プロパティ値