你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

消耗模型

路线规划服务提供了一组参数,用于详细描述特定于车辆的消耗模型。 根据 vehicleEngineType 的值,支持以下两种主要消耗模型:燃烧和电气。 在同一请求中指定属于不同模型的参数是错误做法。 此外,消耗模型参数不能与以下 travelMode 值一起使用:bicycle 和 pedestrian。

消耗模型的参数约束

在这两种消耗模型中,指定参数时都存在一些依赖关系。 这意味着,显式指定某些参数可能需要指定某些其他参数。 以下是需要注意的依赖关系:

  • 所有参数均要求用户指定 constantSpeedConsumption。 如果未指定“constantSpeedConsumption”,则指定任何其他消耗模型参数都是错误的。 “vehicleWeight”参数是此要求的一个例外。
  • accelerationEfficiency 和 decelerationEfficiency 始终必须一起指定(即两者都指定或都不指定)。
  • 如果指定了 accelerationEfficiency 和 decelerationEfficiency,两者值的乘积不得大于 1(防止出现永恒运动)
  • uphillEfficiency 和 downhillEfficiency 始终必须一起指定(即两者都指定或都不指定)。
  • 如果指定了 uphillEfficiency 和 downhillEfficiency,两者值的乘积不得大于 1(防止出现永恒运动)
  • 如果用户指定了 *Efficiency 参数,还必须指定“vehicleWeight”。 如果 vehicleEngineType 为燃料,则还必须指定 fuelEnergyDensityInMJoulesPerLiter
  • maxChargeInkWh 和 currentChargeInkWh 始终必须一起指定(即两者都指定或都不指定)。

注意

如果仅指定了 constantSpeedConsumption,消耗计算不会考虑其他任何消耗(如爬坡和车辆加速)

燃料消耗模型

如果将 vehicleEngineType 设置为“燃烧”,则使用燃烧消耗模型。 下面的参数列表便属于此模型。 参阅“参数”部分,获取详细说明。

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

电力消耗模型

如果将 vehicleEngineType 设置为“电气”,则使用电气消耗模型。 下面的参数列表便属于此模型。 参阅“参数”部分,获取详细说明。

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

合理的消耗参数值

尽管一组特定消耗参数可能满足所有显式要求,但该组参数仍可能被拒绝。 当某个特定参数值或多个参数值组合被认为会导致不合理的消耗值量级时,会发生此情况。 如果出现此情况,则很可能是存在输入错误,应当注意调整所有合理的消耗参数值。 如果一组特定消耗参数遭到拒绝,随之而来的错误消息会解释其原因。 参数的详细说明中包含两种模型的合理值的示例。