消費モデル

  • [アーティクル]

ルーティング サービスでは、車両固有の消費モデルの詳細な説明用のパラメーターのセットが提供されます。 vehicleEngineType の値に応じて、Combustion と Electric の 2 つのプリンシパル消費モデルがサポートされます。 異なるモデルに属するパラメーターを同じ要求で指定するのは正しくありません。 また、消費モデルのパラメーターは、travelMode 値 bicycle および pedestrian と共に使用することはできません。

消費モデルのパラメーターの制約

どちらの消費モデルでも、パラメーターを指定する際にいくつかの依存関係があります。 つまり、一部のパラメーターを明示的に指定する場合は、他のパラメーターの指定が必要になることがあります。 次に、注意すべきこれらの依存関係を示します。

  • ユーザーは、すべてのパラメーターで constantSpeedConsumption を指定する必要があります。 constantSpeedConsumption を指定しない場合、他の消費モデル パラメーターを指定するとエラーになります。 vehicleWeight パラメーターは、この要件の例外です。
  • accelerationEfficiency と decelerationEfficiency は、常に、ペアとして指定する必要があります (つまり、両方とも指定するか、両方とも指定しない)。
  • accelerationEfficiency と decelerationEfficiency の両方を指定する場合、それらの値の積が 1 を超えてはなりません (永久運動を防ぐため)。
  • uphillEfficiency と downhillEfficiency は、常に、ペアとして指定する必要があります (つまり、両方とも指定するか、両方とも指定しない)。
  • uphillEfficiency と downhillEfficiency の両方を指定する場合、それらの値の積が 1 を超えてはなりません (永久運動を防ぐため)。
  • ユーザーは *Efficiency パラメーターを指定する場合、vehicleWeight も指定する必要があります。 vehicleEngineType が combustion の場合は、fuelEnergyDensityInMJoulesPerLiter も指定する必要があります。
  • maxChargeInkWh と currentChargeInkWh は、常に、ペアとして指定する必要があります (つまり、両方とも指定するか、両方とも指定しない)。

Note

constantSpeedConsumption だけを指定する場合は、傾斜や車両加速度などの他の消費側面は消費計算に考慮されません。

Combustion 消費モデル

Combustion 消費モデルは、vehicleEngineType を combustion に設定すると使用されます。 このモデルに属するパラメーターの一覧は次のとおりです。 詳細については、パラメーター セクションを参照してください。

  • constantSpeedConsumptionInLitersPerHundredkm
  • vehicleWeight
  • currentFuelInLiters
  • auxiliaryPowerInLitersPerHour
  • fuelEnergyDensityInMJoulesPerLiter
  • accelerationEfficiency
  • decelerationEfficiency
  • uphillEfficiency
  • downhillEfficiency

Electric 消費モデル

Electric 消費モデルは、vehicleEngineType を electric に設定すると使用されます。 このモデルに属するパラメーターの一覧は次のとおりです。 詳細については、パラメーター セクションを参照してください。

  • constantSpeedConsumptionInkWhPerHundredkm
  • vehicleWeight
  • currentChargeInkWh
  • maxChargeInkWh
  • auxiliaryPowerInkW
  • accelerationEfficiency
  • decelerationEfficiency
  • uphillEfficiency
  • downhillEfficiency

消費パラメーターの適切な値

消費パラメーターの特定のセットは、セットが明示的な要件をすべて満たしても、拒否される場合があります。 そのようなことが起きるのは、特定のパラメーターの値、または複数のパラメーターの値の組み合わせが、結果として不適切な大きさの消費値になると見なされる場合です。 そのような場合、通常は入力エラーを示すので、消費パラメーターがすべて適切な値になるように注意します。 消費パラメーターの特定のセットが拒否された場合は、関連するエラー メッセージに理由の説明が含まれます。 パラメーターの詳細な説明には、両方のモデルの適切な値の例が含まれます。