vehicle_efficiency

constraints object[]

This feature enables efficiency constraints for vehicles, managing how much capacity they utilize. It works by defining a list of constraints for various demand types. These constraints focus on two optional checks during a vehicle's trip:

Minimum Load: Ensures the vehicle is loaded with at least a specified minimum capacity throughout the trip. This promotes efficient vehicle usage. Maximum Remaining Load: Ensures the vehicle's remaining load at the end of a trip doesn't exceed a specified maximum. This discourages returns to the depot with significant unused capacity. Each check can be either strict or weak:

Strict: These constraints must be met. Failing a strict constraint is unacceptable, even if it means no solution is found. Weak: These constraints are preferred but not mandatory. If a weak constraint is violated, a penalty is added to the overall objective value. The penalty for violating a weak constraint is calculated as the sum of two components:

Fixed Penalty: A pre-defined penalty value. Linear Penalty: Calculated by multiplying the cost of over/under capacity by the amount of over/under capacity.

Array [

demand_namestring

Demand name to apply the constraint. This demand type must be present in at least one full booking. If the demand set here is not present in any of the booking as a set demand type, the optimizer will fail the validation.

loaded_min_capacitynumber | nullnullable

Minimum capacity after a series of consecutive pickups before dropoffs. If check is not strict then penalty is added to cost if capacity is less than minimum. If check is strict then route with too small capacity is invalid.

loaded_min_capacity_percentagenumber | nullnullable

The same as loaded_min_capacity but represented as percentage.

loaded_undercapacity_penaltyinteger

Fixed penalty of undercapacity.

Default value: 0

loaded_undercapacity_costinteger

Cost of undercapacity. The additional penalty is calculated as the product of undercapacity_cost and the undercapacity value.

Default value: 0

loaded_undercapacity_check_strictboolean

Flag indicates that check of undercapacity must be strict.

Default value: false

unloaded_max_capacitynumber | nullnullable

Maximum capacity after a series of consecutive dropoffs before pickups. If check is not strict then penalty is added to cost if capacity is greater than maximum. If check is strict then route with too large capacity is invalid.

unloaded_max_capacity_percentagenumber | nullnullable

Same as unloaded_max_capacity but represented as percentage.

unloaded_overcapacity_penaltyinteger

Fixed penalty of overcapacity.

Default value: 0

unloaded_overcapacity_costinteger

Cost of overcapacity. The additional penalty is calculated as the product of overcapacity_cost and the overcapacity value.

Default value: 0

unloaded_overcapacity_check_strictboolean

Flag, indicates, that check for overcapacity must be strict.

Default value: false

]

vehicle_efficiency

"Unknown Type: object,null"