耗用模型

  • 發行項

路線服務會提供一組參數，以詳細描述車輛特定的耗用模型。 視 vehicleEngineType 的值而定，支援兩種主要的耗用模型：燃燒和電子。 在同一要求中指定屬於不同模型的參數，這是不正確的。 此外，耗用模型參數不能搭配下列 travelMode 值使用：bicycle 和 pedestrian。

耗用模型的參數限制式

在這兩個耗用模型中，指定參數時會有一些相依性。 這表示，明確指定某些參數可能需要指定一些其他參數。 以下是需要注意的相依性：

  • 所有參數都需要由使用者指定 constantSpeedConsumption。 如果未指定 constantSpeedConsumption，則指定任何其他取用模型參數時會發生錯誤。 vehicleWeight 參數是此需求的例外狀況。
  • accelerationEfficiency 和 decelerationEfficiency 一律必須指定為一對 (也就是兩個並存或無)。
  • 如果指定 accelerationEfficiency 和 decelerationEfficiency，其值的產品必不能大於 1 (以防永恆運動)。
  • uphillEfficiency 和 downhillEfficiency 一律必須指定為一對 (也就是兩個並存或無)。
  • 如果指定 uphillEfficiency 和 downhillEfficiency，其值的產品必不能大於 1 (以防永恆運動)。
  • 如果使用者指定 *Efficiency 參數，則也必須指定 vehicleWeight。 若 vehicleEngineType 為 combustion，也必須指定 fuelEnergyDensityInMJoulesPerLiter。
  • maxChargeInkWh 和 currentChargeInkWh 一律必須指定為一對 (也就是兩個並存或無)。

注意

如果僅指定 constantSpeedConsumption，沒有為耗用計算考慮其他耗用層面，如坡度和載具加速。

燃燒耗用模型

vehicleEngineType 設為燃燒時，會使用燃燒耗用模型。 屬於此模型的參數清單如下。 請參閱 [參數] 區段，取得詳細說明。

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

電子耗用模型

vehicleEngineType 設為電子時，會使用電子耗用模型。 屬於此模型的參數清單如下。 請參閱 [參數] 區段，取得詳細說明。

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

合理的耗用參數值

特定的耗用參數集可能遭拒絕，即使此集可能滿足所有明確需求。 若特定參數的值或數個參數的值組合，被視為會造成不合理的耗用值範圍，即會發生這種情況。 如果發生這種情況，最有可能表示輸入錯誤，因為原先已適當處理以容納耗用參數的所有合理值。 如果已拒絕特定一組取用參數，則伴隨而來的錯誤訊息會包含原因的文字說明。 參數的詳細說明含有兩種模型合理值的範例。