-> Depot Reload / Multi Tours
Allow vehicles to do more than one tour
Description:
In certain use cases, it is necessary to allow vehicles to do more than one tour a day and to perform a reload between the tours.
Our software supports a loading (for deliveries) and an unloading (for pickups) time at the depot in the morning before the first tour, between tours during the day and after the last tour. The loading and unloading time can be defined globally (valid for all vehicles) in the query parameter or individually at a vehicle level.
In general, it can be differentiated between three use cases.
- A driver loads the vehicle by himself in the morning and unloads the vehicle by himself after the last tour.
- A driver does not load the vehicle by himself in the morning and does not unload the vehicle by himself after the last tour.
- Both use cases can be combined as well:
- A driver loads the vehicle by himself in the morning but does not unload the vehicle by himself after the last tour.
- A driver does not load the vehicle by himself in the morning but unloads the vehicle by himself after the last tour.
Note that the duration of the loading and unloading time will have an impact on the drivers working hours and the departure and return time of the vehicle based on the use case and how it is configured. The driver's working hours can be defined in the parameter max_tour_duration
for each vehicle or vehicle type. The departure and return times can be defined by the parameters departure_time_from
, departure_time_to
and return_time_to
.
The loading and unloading times between tours will always be considered as the driver's working hours.
How to implement:
All parameters can be found in the API Reference: calcrouteoptimizedtimewindow
- Define the global settings in the query parameter:
- To activate this feature set the parameter
depot_reload
= true.
If nothing is set the feature is not active, due to the default is set to false. - Set
initial_loading_is_working_time
= true, if the loading time shall be considered as the drivers working hours or - Set
initial_loading_is_working_time
= false, if the loading time shall NOT be considered as the drivers working hours. - Set
final_unloading_is_working_time
= true, if the unloading time shall be considered as the drivers working hours or - Set
final_unloading_is_working_time
= false, if the unloading time shall NOT be considered as the drivers working hours. - Set
depot_loading_time
= <seconds>, for the duration of the loading. - Set
depot_unloading_time
= <seconds>, for the duration of the unloading.
- To activate this feature set the parameter
- On a vehicle level the loading and unloading times can be defined individually as fixed + variable els seconds per load in the
depot_els_config
object:- Set
loading_els_config
->fixed_els_seconds
= <seconds>, for the fixed loading time. - Set
loading_els_config
->variable_els_seconds_per_load
= <seconds>, for the variable loading time per load. - Set
unloading_els_config
->fixed_els_seconds
= <seconds>, for the fixed unloading time. - Set
unloading_els_config
->variable_els_seconds_per_load
= <seconds>, for the variable unloading time per load.
- Set
The load defines the actual used amount of the capacity.
The total loading time is then calculated:
total loading time = fixed_els_seconds
+ (variable_els_seconds_per_load
* load)
The same logic is applied for calculating the unload time.
An example can look like:
{
"query_parameters": {
"depot_reload": true,
"initial_loading_is_working_time": true,
"final_unloading_is_working_time": true,
"depot_loading_time": 1800,
"depot_unloading_time": 600
},
" body": {
"deliverydata": [...],
"vehicles": [
{
"name": "Vehicle_1",
"depot_els_config": {
"loading_els_config": {
"variable_els_seconds_per_load": [
0,
120,
0
],
"fixed_els_seconds": 1200
},
"unloading_els_config": {
"variable_els_seconds_per_load": [
0,
120,
0
],
"fixed_els_seconds": 900
}
}
}
]
}
}
*In this example the depot_els_config
will overwrite the depot_loading_time
and depot_unloading_time
from the query parameter.
Updated over 1 year ago