xRoute: electricityConsumption validation for electric vehicles when using VehicleParametersAtWaypoint

[CAPcargo]

Hi,

We are currently working with electric vehicles in xRoute and have a question regarding the usage of electricityConsumption in combination with VehicleParametersAtWaypoint.

In our request, we define electricityConsumption on each waypoint via
VehicleParameters/consumptionValues/electricityConsumption, as described in the documentation for waypoint-based vehicle parameter adjustments.

However, we still receive the following limitation:
"<resultLimitations xmlns:ns4="http://service.xserver.ptvgroup.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ns4:ParameterInconsistencyLimitation" parameter="/profile/vehicleProfile/engine/@electricityConsumption" value="0.0" relatedParameter="/profile/vehicleProfile/engine/@engineType" relatedValue="ELECTRIC" message="The electricity consumption must be specified for electric vehicles."/>"

From this behavior, it seems that electricityConsumption must also be set on the base vehicleProfile.engine, even if it is already provided per waypoint.

Could you please confirm:

- Is it mandatory to always define electricityConsumption on the base vehicleProfile.engine for engineType=ELECTRIC?
- Are the values provided in VehicleParametersAtWaypoint only treated as overrides, but not sufficient to satisfy the base validation?

Additionally, we would like to mention that we do not encounter this issue when using fuelConsumption in VehicleParametersAtWaypoint for combustion vehicles - in that case, no similar validation error is returned.

If this is the intended behavior, it would be helpful to clarify this in the documentation, as it may currently suggest that waypoint values alone are sufficient.

Please find the request attached for reference.

request.txt

(6.22 KiB) Downloaded 7 times

Thanks in advance for your clarification.

Best regards

[Bernd Welter]

Hi there,

How about this: In the technical concepts there's some more information:

• Routing.VehicleParameters

Among other info the technical concept says:

• Required parameters: ELECTRIC requires electricityType, electricityConsumption to be specified:

  

• Value range:

  

Is that what you were looking for?

Bernd

PS: Would be better if it also shows that info in the API doc itself.

[CAPcargo]

Hi Bernd,

thanks for your response and for pointing to the documentation.

We are aware of the requirement that for engineType=ELECTRIC, both electricityType and electricityConsumption must be specified.

However, in our case, this requirement is already fulfilled - we do provide electricityConsumption, but at the waypoint level via VehicleParametersAtWaypoint/consumptionValues.

The issue we are facing is specifically that:

When electricityConsumption is only defined at waypoint level, xRoute still returns a validation error for the base vehicleProfile.engine
This behavior does not occur for combustion vehicles, where fuelConsumption defined at waypoint level is accepted without requiring it on the base engine

So, the core of our question is:

- Is it expected that electricityConsumption must always be defined on the base vehicleProfile.engine, even when it is fully specified via VehicleParametersAtWaypoint?

Or in other words:
- Are VehicleParametersAtWaypoint values not considered during validation of required engine parameters?

From our perspective, this behavior seems inconsistent with how fuelConsumption is handled, and also a bit unclear from the documentation.

Could you please clarify if this is intended behavior or a limitation?

Thanks in advance for your help.