- Request
- Responses
- 200 OK
- Body
- error_2_error
- mvrp_response
- task_info_1_status
- mvrp_response_dropped_locations_item
- solution_metrics_1
- solver_options_1
- mvrp_response_routes_item
- vehicle
- detailed_cost_1
- mvrp_response_zones_item
- coordinate_2
- client_service_duration_0
- crossdock_service_duration_0
- depot_duration_0
- mvrp_response_dropped_locations_optional_tags_item
- mvrp_response_dropped_locations_penalty
- dropped_locations_quant_0_1
- mvrp_response_dropped_locations_rolling_throughput
- service_duration_2_0
- service_durations
- shared_service_duration_0
- mvrp_response_dropped_locations_shipment_size
- mvrp_response_dropped_locations_split_info
- mvrp_response_dropped_locations_throughput
- mvrp_response_dropped_locations_time_windows_item
- mvrp_response_dropped_locations_transit_time
- solver_options_1_balanced_groups_item
- solver_options_1_location_groups_item
- solver_options_1_penalty
- solver_options_1_points_throughputs_item
- solver_options_1_template_rest_schedules_item
- route_metrics_1
- route_element_1
- mvrp_response_routes_global_proximity_attraction_point
- mvrp_response_routes_shift
- vehicle_capacity
- vehicle_close_locations_item
- vehicle_cost_0
- vehicle_cost_1
- vehicle_fixed_work_breaks_item
- vehicle_optional_zones_item
- vehicle_payout_0
- vehicle_penalty
- vehicle_planned_route
- vehicle_rest_schedule
- vehicle_shifts_item
- vehicle_specs
- vehicle_trailer
- vehicle_visited_locations_item
- vehicle_walking_courier
- detailed_cost_1_raw_metrics_item
- detailed_cost_1_subcosts_item
- mvrp_response_zones_geometry
- dropped_locations_penalty_delivery_deadline
- dropped_locations_penalty_depot_expiring_time
- dropped_locations_penalty_depot_ready_time
- penalty_drop_0_3
- dropped_locations_penalty_early
- dropped_locations_penalty_late
- dropped_locations_penalty_out_of_time
- dropped_locations_penalty_rolling_throughput
- dropped_locations_penalty_throughput
- dropped_locations_penalty_time_between_visits
- dropped_locations_penalty_transit_time
- rolling_throughput_kg_per_hour_0_item
- rolling_throughput_units_per_hour_0_item
- rolling_throughput_vehicle_count_0_item
- dropped_locations_shipment_size_volume
- throughput_kg_per_hour_0_item
- throughput_units_per_hour_0_item
- throughput_vehicle_count_0_item
- solver_options_1_balanced_groups_penalty
- solver_options_1_penalty_close_location_groups
- solver_options_1_penalty_drop_penalty_percentage
- solver_options_1_penalty_multiorders
- solver_options_1_penalty_split_orders_percentage
- solver_options_1_points_throughputs_penalty
- solver_options_1_points_throughputs_point
- solver_options_1_points_throughputs_throughput
- template_rest_schedules_breaks_0_item
- route_node_depot
- route_node_location_1
- route_node_work_break
- route_node_courier_position
- route_element_1_failed_time_window
- route_element_1_overtime
- route_element_1_probably_failed_time_window
- route_element_1_violations_0
- route_element_1_violations_1
- routes_global_proximity_attraction_point_optional_tags_item
- routes_global_proximity_attraction_point_penalty_1
- global_proximity_attraction_point_quant_0_1
- routes_global_proximity_attraction_point_rolling_throughput
- routes_global_proximity_attraction_point_shipment_size
- routes_global_proximity_attraction_point_throughput
- routes_global_proximity_attraction_point_time_windows_item
- routes_global_proximity_attraction_point_transit_time
- routes_shift_end_1
- routes_shift_start_1
- vehicle_capacity_limits
- vehicle_capacity_volume
- vehicle_close_locations_distance_till_service_m
- vehicle_close_locations_duration_till_service_s
- vehicle_penalty_arrival_after_start
- vehicle_penalty_empty_runs
- vehicle_penalty_min_stop_weight
- vehicle_planned_route_locations_item
- vehicle_planned_route_start_time_0_item
- vehicle_planned_route_work_breaks_item
- vehicle_rest_schedule_breaks_0_item
- vehicle_shifts_penalty
- vehicle_trailer_capacity
- vehicle_trailer_cost
- vehicle_trailer_max_capacity_difference
- vehicle_trailer_rolling_time
- vehicle_walking_courier_capacity
- vehicle_walking_courier_cost
- vehicle_walking_courier_restrictions
- detailed_cost_1_raw_metrics_raw_metrics_item
- detailed_cost_1_raw_metrics_subcosts_item
- detailed_cost_1_subcosts_raw_metrics_item
- detailed_cost_1_subcosts_subcosts_item
- points_throughputs_penalty_throughput
- breaks_penalty
- route_depot_location
- route_node_depot_used_projection
- route_location_1
- route_node_location_1_used_projection
- route_work_break
- route_node_work_break_used_projection
- route_courier_position
- route_node_courier_position_used_projection
- global_proximity_attraction_point_penalty_delivery_deadline
- global_proximity_attraction_point_penalty_depot_expiring_time
- global_proximity_attraction_point_penalty_depot_ready_time
- global_proximity_attraction_point_penalty_drop_0_1
- global_proximity_attraction_point_penalty_early
- global_proximity_attraction_point_penalty_late
- global_proximity_attraction_point_penalty_out_of_time
- global_proximity_attraction_point_penalty_rolling_throughput
- global_proximity_attraction_point_penalty_throughput
- global_proximity_attraction_point_penalty_time_between_visits
- global_proximity_attraction_point_penalty_transit_time
- global_proximity_attraction_point_rolling_throughput_kg_per_hour_0_item
- global_proximity_attraction_point_rolling_throughput_units_per_hour_0_item
- global_proximity_attraction_point_rolling_throughput_vehicle_count_0_item
- global_proximity_attraction_point_shipment_size_volume
- global_proximity_attraction_point_throughput_kg_per_hour_0_item
- global_proximity_attraction_point_throughput_units_per_hour_0_item
- global_proximity_attraction_point_throughput_vehicle_count_0_item
- shift_end_failed_time_window
- shift_end_overtime
- shift_end_probably_failed_time_window
- end_violations_0_1
- end_violations_1_1
- shift_start_failed_time_window
- shift_start_overtime
- shift_start_probably_failed_time_window
- start_violations_0_1
- start_violations_1_1
- shifts_penalty_early
- shifts_penalty_late
- shifts_penalty_max_mileage
- shifts_penalty_out_of_time
- shifts_penalty_stop_excess
- shifts_penalty_stop_lack
- shifts_penalty_unique_stop_lack
- trailer_capacity_limits
- trailer_capacity_volume
- walking_courier_restrictions_max_parking_duration_s
- walking_courier_restrictions_max_parking_walking_distance_m
- walking_courier_restrictions_max_walking_edge_distance_m
- raw_metrics_raw_metrics_item_14
- raw_metrics_subcosts_item_12
- subcosts_raw_metrics_item_11
- subcosts_subcosts_item_10
- raw_metrics_raw_metrics_item_7
- raw_metrics_subcosts_item_5
- subcosts_raw_metrics_item_4
- subcosts_subcosts_item_3
- penalty_early
- penalty_late
- route_depot_location_package_throughput
- route_depot_location_penalty
- route_depot_location_throughput
- route_depot_location_time_windows_item
- route_depot_location_time_windows_loading
- route_depot_location_time_windows_refilling
- route_depot_location_time_windows_unloading
- route_depot_location_unfeasible_reasons_0
- route_depot_location_unfeasible_reasons_1
- route_depot_location_unfeasible_reasons_2
- route_location_1_optional_tags_item
- route_location_1_penalty
- route_location_1_quant_0
- route_location_1_rolling_throughput
- route_location_1_shipment_size
- route_location_1_split_info
- route_location_1_throughput
- route_location_1_time_windows_item
- route_location_1_transit_time
- route_location_1_unfeasible_reasons_0
- route_location_1_unfeasible_reasons_1
- route_location_1_unfeasible_reasons_2
- route_location_1_unfeasible_reasons_3
- route_location_1_unfeasible_reasons_4
- route_location_1_unfeasible_reasons_5
- route_location_1_unfeasible_reasons_6
- route_location_1_unfeasible_reasons_7
- route_location_1_unfeasible_reasons_8
- route_location_1_unfeasible_reasons_9
- route_work_break_penalty
- raw_metrics_raw_metrics_item_13
- raw_metrics_subcosts_item_13
- subcosts_raw_metrics_item_13
- subcosts_subcosts_item_13
- raw_metrics_raw_metrics_item_10
- raw_metrics_subcosts_item_9
- subcosts_raw_metrics_item_9
- subcosts_subcosts_item_9
- raw_metrics_raw_metrics_item_6
- raw_metrics_subcosts_item_6
- subcosts_raw_metrics_item_6
- subcosts_subcosts_item_6
- raw_metrics_raw_metrics_item_3
- raw_metrics_subcosts_item_2
- subcosts_raw_metrics_item_2
- subcosts_subcosts_item_2
- route_depot_location_package_throughput_kg_per_hour_0_item
- route_depot_location_package_throughput_units_per_hour_0_item
- route_depot_location_penalty_early
- route_depot_location_penalty_late
- route_depot_location_penalty_out_of_time
- route_depot_location_penalty_package_throughput
- route_depot_location_penalty_throughput
- route_depot_location_throughput_kg_per_hour_0_item
- route_depot_location_throughput_units_per_hour_0_item
- route_depot_location_throughput_vehicle_count_0_item
- route_depot_location_time_windows_loading_penalty
- route_depot_location_time_windows_loading_time_windows_item
- route_depot_location_time_windows_refilling_penalty
- route_depot_location_time_windows_refilling_time_windows_item
- route_depot_location_time_windows_unloading_penalty
- route_depot_location_time_windows_unloading_time_windows_item
- route_location_1_penalty_delivery_deadline
- route_location_1_penalty_depot_expiring_time
- route_location_1_penalty_depot_ready_time
- route_location_1_penalty_drop_0
- route_location_1_penalty_early
- route_location_1_penalty_late
- route_location_1_penalty_out_of_time
- route_location_1_penalty_rolling_throughput
- route_location_1_penalty_throughput
- route_location_1_penalty_time_between_visits
- route_location_1_penalty_transit_time
- route_location_1_rolling_throughput_kg_per_hour_0_item
- route_location_1_rolling_throughput_units_per_hour_0_item
- route_location_1_rolling_throughput_vehicle_count_0_item
- route_location_1_shipment_size_volume
- route_location_1_throughput_kg_per_hour_0_item
- route_location_1_throughput_units_per_hour_0_item
- route_location_1_throughput_vehicle_count_0_item
- unfeasible_reasons_incompatibilities_item_2
- unfeasible_reasons_incompatibilities_item
- route_work_break_penalty_early
- route_work_break_penalty_late
- raw_metrics_raw_metrics_item_12
- raw_metrics_subcosts_item_14
- subcosts_raw_metrics_item_14
- subcosts_subcosts_item_14
- raw_metrics_raw_metrics_item_11
- raw_metrics_subcosts_item_11
- subcosts_raw_metrics_item_12
- subcosts_subcosts_item_12
- raw_metrics_raw_metrics_item_9
- raw_metrics_subcosts_item_10
- subcosts_raw_metrics_item_10
- subcosts_subcosts_item_11
- raw_metrics_raw_metrics_item_8
- raw_metrics_subcosts_item_8
- subcosts_raw_metrics_item_8
- subcosts_subcosts_item_8
- raw_metrics_raw_metrics_item_5
- raw_metrics_subcosts_item_7
- subcosts_raw_metrics_item_7
- subcosts_subcosts_item_7
- raw_metrics_raw_metrics_item_4
- raw_metrics_subcosts_item_4
- subcosts_raw_metrics_item_5
- subcosts_subcosts_item_5
- raw_metrics_raw_metrics_item_2
- raw_metrics_subcosts_item_3
- subcosts_raw_metrics_item_3
- subcosts_subcosts_item_4
- raw_metrics_raw_metrics_item_1
- raw_metrics_subcosts_item_1
- subcosts_raw_metrics_item_1
- subcosts_subcosts_item_1
- time_windows_loading_penalty_early
- time_windows_loading_penalty_late
- time_windows_loading_penalty_out_of_time
- time_windows_refilling_penalty_early
- time_windows_refilling_penalty_late
- time_windows_refilling_penalty_out_of_time
- time_windows_unloading_penalty_early
- time_windows_unloading_penalty_late
- time_windows_unloading_penalty_out_of_time
- incompatibilities_types_item
- incompatibilities_zones_item
- raw_metrics_raw_metrics_item
- raw_metrics_subcosts_item
- subcosts_raw_metrics_item
- subcosts_subcosts_item
- 201 Created
- 202 Accepted
- 404 Not Found
- 410 Gone
- 500 Internal Server Error
Get task result
Get status or result of MVRP task.
Request
GET
https://courier.yandex.ru/vrs/api/v1/result/mvrp/{id}
Path parameters
Name |
Description |
id* |
Type: string<byte> Task ID to query status or result. |
Responses
200 OK
Task has been completed.
Body
application/json
{
"result": {
"detailed_cost_metrics": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"value": 0
}
],
"subcosts": [
{
"name": "string",
"value": 0
}
],
"value": 0
}
],
"subcosts": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"value": 0
}
],
"subcosts": [
{
"name": "string",
"value": 0
}
],
"value": 0
}
],
"value": 0
}
],
"subcosts": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"value": 0
}
],
"subcosts": [
{
"name": "string",
"value": 0
}
],
"value": 0
}
],
"subcosts": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"value": 0
}
],
"subcosts": [
{
"name": "string",
"value": 0
}
],
"value": 0
}
],
"value": 0
}
],
"value": 0
}
],
"subcosts": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"value": 0
}
],
"subcosts": [
{
"name": "string",
"value": 0
}
],
"value": 0
}
],
"subcosts": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"value": 0
}
],
"subcosts": [
{
"name": "string",
"value": 0
}
],
"value": 0
}
],
"value": 0
}
],
"subcosts": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"value": 0
}
],
"subcosts": [
{
"name": "string",
"value": 0
}
],
"value": 0
}
],
"subcosts": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"value": 0
}
],
"subcosts": [
{
"name": "string",
"value": 0
}
],
"value": 0
}
],
"value": 0
}
],
"value": 0
}
],
"value": 0
}
],
"subcosts": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"value": 0
}
],
"subcosts": [
{
"name": "string",
"value": 0
}
],
"value": 0
}
],
"subcosts": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"value": 0
}
],
"subcosts": [
{
"name": "string",
"value": 0
}
],
"value": 0
}
],
"value": 0
}
],
"subcosts": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"value": 0
}
],
"subcosts": [
{
"name": "string",
"value": 0
}
],
"value": 0
}
],
"subcosts": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"value": 0
}
],
"subcosts": [
{
"name": "string",
"value": 0
}
],
"value": 0
}
],
"value": 0
}
],
"value": 0
}
],
"subcosts": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"value": 0
}
],
"subcosts": [
{
"name": "string",
"value": 0
}
],
"value": 0
}
],
"subcosts": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"value": 0
}
],
"subcosts": [
{
"name": "string",
"value": 0
}
],
"value": 0
}
],
"value": 0
}
],
"subcosts": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"value": 0
}
],
"subcosts": [
{
"name": "string",
"value": 0
}
],
"value": 0
}
],
"subcosts": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"value": 0
}
],
"subcosts": [
{
"name": "string",
"value": 0
}
],
"value": 0
}
],
"value": 0
}
],
"value": 0
}
],
"value": 0
}
],
"value": 0
}
],
"subcosts": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"value": 0
}
],
"subcosts": [
{
"name": "string",
"value": 0
}
],
"value": 0
}
],
"subcosts": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"value": 0
}
],
"subcosts": [
{
"name": "string",
"value": 0
}
],
"value": 0
}
],
"value": 0
}
],
"subcosts": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"value": 0
}
],
"subcosts": [
{
"name": "string",
"value": 0
}
],
"value": 0
}
],
"subcosts": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"value": 0
}
],
"subcosts": [
{
"name": "string",
"value": 0
}
],
"value": 0
}
],
"value": 0
}
],
"value": 0
}
],
"subcosts": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"value": 0
}
],
"subcosts": [
{
"name": "string",
"value": 0
}
],
"value": 0
}
],
"subcosts": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"value": 0
}
],
"subcosts": [
{
"name": "string",
"value": 0
}
],
"value": 0
}
],
"value": 0
}
],
"subcosts": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"value": 0
}
],
"subcosts": [
{
"name": "string",
"value": 0
}
],
"value": 0
}
],
"subcosts": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"value": 0
}
],
"subcosts": [
{
"name": "string",
"value": 0
}
],
"value": 0
}
],
"value": 0
}
],
"value": 0
}
],
"value": 0
}
],
"subcosts": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"value": 0
}
],
"subcosts": [
{
"name": "string",
"value": 0
}
],
"value": 0
}
],
"subcosts": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"value": 0
}
],
"subcosts": [
{
"name": "string",
"value": 0
}
],
"value": 0
}
],
"value": 0
}
],
"subcosts": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"value": 0
}
],
"subcosts": [
{
"name": "string",
"value": 0
}
],
"value": 0
}
],
"subcosts": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"value": 0
}
],
"subcosts": [
{
"name": "string",
"value": 0
}
],
"value": 0
}
],
"value": 0
}
],
"value": 0
}
],
"subcosts": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"value": 0
}
],
"subcosts": [
{
"name": "string",
"value": 0
}
],
"value": 0
}
],
"subcosts": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"value": 0
}
],
"subcosts": [
{
"name": "string",
"value": 0
}
],
"value": 0
}
],
"value": 0
}
],
"subcosts": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"value": 0
}
],
"subcosts": [
{
"name": "string",
"value": 0
}
],
"value": 0
}
],
"subcosts": [
{
"name": "string",
"raw_metrics": [
{
"name": "string",
"value": 0
}
],
"subcosts": [
{
"name": "string",
"value": 0
}
],
"value": 0
}
],
"value": 0
}
],
"value": 0
}
],
"value": 0
}
],
"value": 0
}
],
"value": 0
}
],
"dropped_locations": [
{
"address": "string",
"allow_trailers": false,
"can_be_merged": true,
"can_be_split": false,
"client_id": 0,
"client_service_duration_s": {
"fixed": 0,
"scaled": 0
},
"comments": "string",
"crossdock_mode": "deny",
"crossdock_service_duration_s": {
"fixed": 0,
"scaled": 0
},
"custom_value": 0,
"delivery_deadline": "string",
"delivery_to": 0,
"delivery_to_any": [
0,
"string"
],
"depot_duration_s": {
"fixed": 0,
"scaled": 0
},
"depot_expiring_time": "string",
"depot_id": [
0,
"string"
],
"depot_ready_time": "string",
"description": "string",
"drop_reason": "string",
"dropped_ratio": 0,
"hard_time_window": "string",
"hard_window": false,
"id": 0,
"ignore_zones_compatibility": false,
"in_lifo_order": false,
"load_types": [
"string"
],
"max_split_parts": 10,
"max_total_vehicles": 0,
"may_drop_in_crossdock": true,
"optional_tags": [
{
"tag": "string",
"value": 0
}
],
"parking_service_duration_s": 0,
"phone": "string",
"pickup_from_any": false,
"pickup_id": 0,
"pickup_must_reach_depot": false,
"point": {
"lat": 0,
"lon": 0
},
"preset_id": "string",
"quant": 0,
"ref": "string",
"required_tags": [
"string"
],
"sequence_order": 0,
"service_duration_s": {
"fixed": 0,
"scaled": 0
},
"service_durations": {
"client": {
"fixed": 0,
"scaled": 0
},
"crossdock": {
"fixed": 0,
"scaled": 0
},
"depot": {
"fixed": 0,
"scaled": 0
},
"location": {
"fixed": 0,
"scaled": 0
},
"parking": 0,
"stop": {
"fixed": 0,
"scaled": 0
}
},
"shared_service_duration_s": {
"fixed": 0,
"scaled": 0
},
"shared_with_company_ids": [
0
],
"soft_depot_expiring_time": "string",
"soft_depot_ready_time": "string",
"split_parts_must_fill_whole_vehicle": false,
"time_window": "string",
"time_windows": [
{
"hard_time_window": "string",
"time_window": "string"
}
],
"title": "string",
"type": "depot",
"use_in_proximity": true,
"transit_time": {
"hard_limit_s": 0,
"limit_s": 0
},
"throughput": {
"kg_per_hour": [
{
"time_window": "string",
"value": 0
}
],
"units_per_hour": [
{
"time_window": "string",
"value": 0
}
],
"vehicle_count": [
{
"time_window": "string",
"value": 0
}
]
},
"split_info": {
"order_ratio": 0,
"part_id": 0,
"parts_count": 0,
"units": 0,
"volume_cbm": 0,
"weight_kg": 0
},
"shipment_size": {
"units": 0,
"volume_cbm": 0,
"weight_kg": 0,
"volume": {
"align": "all_axes",
"depth_m": 0,
"height_m": 0,
"type": "bulk",
"width_m": 0
},
"custom": 0
},
"rolling_throughput": {
"kg_per_hour": [
{
"time_window": "string",
"value": 0
}
],
"units_per_hour": [
{
"time_window": "string",
"value": 0
}
],
"vehicle_count": [
{
"time_window": "string",
"value": 0
}
]
},
"penalty": {
"drop": {
"fixed": 0,
"scaled": 1000000
},
"transit_time": {
"fixed": 0,
"minute": 0
},
"time_between_visits": {
"fixed": 1000,
"minute": 17
},
"throughput": {
"fixed": 1000,
"kg": 50,
"unit": 100,
"vehicle": 100000
},
"rolling_throughput": {
"fixed": 1000,
"kg": 50,
"unit": 100,
"vehicle": 100000
},
"out_of_time": {
"fixed": 1000,
"minute": 17
},
"late": {
"fixed": 1000,
"minute": 17
},
"early": {
"fixed": 1000,
"minute": 17
},
"depot_ready_time": {
"fixed": 1000,
"minute": 17
},
"depot_expiring_time": {
"fixed": 1000,
"minute": 17
},
"delivery_deadline": {
"fixed": 1000,
"minute": 17
}
}
}
],
"metrics": {
"arrival_after_start_penalty": 0,
"assigned_locations_count": 0,
"balanced_group_custom_value_deviation": 0,
"balanced_group_distance_deviation_m": 0,
"balanced_group_duration_deviation_s": 0,
"balanced_group_kg_deviation": 0,
"balanced_group_penalty": 0,
"balanced_group_served_order_count_deviation": 0,
"balanced_group_stop_count_deviation": 0,
"balanced_group_unit_deviation": 0,
"close_location_groups_extra_points": 0,
"close_location_groups_extra_vehicles": 0,
"close_location_groups_extra_visits": 0,
"close_location_groups_penalty": 0,
"depot_throughput_violation_kg": 0,
"depot_throughput_violation_kg_per_hour": 0,
"depot_throughput_violation_units": 0,
"depot_throughput_violation_units_per_hour": 0,
"depot_throughput_violation_vehicles": 0,
"drop_penalty_percentage": 0,
"dropped_locations_count": 0,
"early_depot_count": 0,
"early_locations_count": 0,
"early_shifts_count": 0,
"empty_runs_penalty": 0,
"failed_dropped_breaks_count": 0,
"failed_dropped_breaks_duration_s": 0,
"failed_dropped_breaks_penalty": 0,
"failed_max_work_duration_count": 0,
"failed_min_work_duration_count": 0,
"failed_time_window_depot_count": 0,
"failed_time_window_depot_count_penalty": 0,
"failed_time_window_depot_duration_penalty": 0,
"failed_time_window_depot_duration_s": 0,
"failed_time_window_depots_total_penalty": 0,
"failed_time_window_locations_count": 0,
"failed_time_window_locations_count_penalty": 0,
"failed_time_window_locations_duration_penalty": 0,
"failed_time_window_locations_duration_s": 0,
"failed_time_window_locations_total_penalty": 0,
"failed_time_window_shifts_count": 0,
"failed_time_window_shifts_count_penalty": 0,
"failed_time_window_shifts_duration_penalty": 0,
"failed_time_window_shifts_duration_s": 0,
"failed_time_window_shifts_total_penalty": 0,
"failed_work_duration_count": 0,
"failed_work_duration_count_penalty": 0,
"failed_work_duration_penalty": 0,
"failed_work_duration_s": 0,
"failed_work_duration_total_penalty": 0,
"first_edges_penalty": 0,
"global_proximity": 0,
"intermediate_location_distance_threshold_m": 1,
"intermediate_location_duration_threshold_s": 1,
"last_edges_penalty": 0,
"late_depot_count": 0,
"late_locations_count": 0,
"late_shifts_count": 0,
"lateness_risk_locations_count": 0,
"max_distance_from_depot_m": 0,
"max_distance_to_attraction_point_m": 0,
"max_distance_to_garage_m": 0,
"max_drop_percentage_penalty": 0,
"max_split_orders_percentage_penalty": 0,
"max_vehicle_runs": 0,
"multiorders_extra_points": 0,
"multiorders_extra_vehicles": 0,
"multiorders_extra_visits": 0,
"new_balanced_group_custom_value_deviation": 0,
"new_balanced_group_distance_deviation_m": 0,
"new_balanced_group_duration_deviation_s": 0,
"new_balanced_group_kg_deviation": 0,
"new_balanced_group_penalty": 0,
"new_balanced_group_served_order_count_deviation": 0,
"new_balanced_group_stop_count_deviation": 0,
"new_balanced_group_unit_deviation": 0,
"new_global_proximity": 0,
"new_objective_minimum": 0,
"new_total_cost_with_penalty": 0,
"new_total_global_proximity_distance_m": 0,
"new_total_global_proximity_duration_s": 0,
"new_total_global_proximity_penalty": 0,
"new_total_guaranteed_penalty": 0,
"new_total_penalty": 0,
"new_total_stop_count_penalty": 0,
"new_total_stops": 0,
"number_of_routes": 0,
"objective_minimum": 0,
"old_balanced_group_custom_value_deviation": 0,
"old_balanced_group_distance_deviation_m": 0,
"old_balanced_group_duration_deviation_s": 0,
"old_balanced_group_kg_deviation": 0,
"old_balanced_group_penalty": 0,
"old_balanced_group_served_order_count_deviation": 0,
"old_balanced_group_stop_count_deviation": 0,
"old_balanced_group_unit_deviation": 0,
"old_global_proximity": 0,
"old_objective_minimum": 0,
"old_total_cost_with_penalty": 0,
"old_total_global_proximity_distance_m": 0,
"old_total_global_proximity_duration_s": 0,
"old_total_global_proximity_penalty": 0,
"old_total_guaranteed_penalty": 0,
"old_total_penalty": 0,
"old_total_stop_count_penalty": 0,
"old_total_stops": 0,
"operations_per_second": 0,
"optimization_steps": 0,
"overtime_duration_penalty": 0,
"overtime_duration_s": 0,
"overtime_penalty": 0,
"overtime_shifts_count": 0,
"overtime_shifts_count_penalty": 0,
"proximity": 0,
"route_custom_cost": 0,
"route_payout": 0,
"run_custom_cost": 0,
"run_payout": 0,
"shift_custom_cost": 0,
"shift_payout": 0,
"shift_total_custom_cost": 0,
"shift_total_payout": 0,
"skip_intermediate_location_penalty": 0,
"split_orders_percentage": 0,
"total_cost": 0,
"total_cost_with_penalty": 0,
"total_custom_cost": 0,
"total_depot_penalty": 0,
"total_drop_penalty": 0,
"total_duration_cost": 0,
"total_duration_s": 0,
"total_early_count": 0,
"total_early_duration_s": 0,
"total_early_penalty": 0,
"total_empty_distance_m": 0,
"total_failed_delivery_deadline_count": 0,
"total_failed_delivery_deadline_duration_s": 0,
"total_failed_delivery_deadline_penalty": 0,
"total_failed_time_between_visits_count": 0,
"total_failed_time_between_visits_duration_s": 0,
"total_failed_time_window_count": 0,
"total_failed_time_window_duration_s": 0,
"total_failed_time_window_penalty": 0,
"total_fails_penalty": 0,
"total_fixed_cost": 0,
"total_global_proximity_distance_m": 0,
"total_global_proximity_duration_s": 0,
"total_global_proximity_penalty": 0,
"total_guaranteed_penalty": 0,
"total_late_count": 0,
"total_late_duration_s": 0,
"total_late_penalty": 0,
"total_lateness_risk_probability": 0,
"total_locations_cost": 0,
"total_middle_depots": 0,
"total_mileage_penalty": 0,
"total_min_stop_weight_penalty": 0,
"total_multiorders_penalty": 0,
"total_non_empty_distance_m": 0,
"total_optional_tags_cost": 0,
"total_optional_zones_cost": 0,
"total_payout": 0,
"total_penalty": 0,
"total_probable_penalty": 0,
"total_proximity_distance_m": 0,
"total_proximity_duration_s": 0,
"total_proximity_penalty": 0,
"total_rest_duration_s": 0,
"total_runs_cost": 0,
"total_served_orders": 0,
"total_service_duration_s": 0,
"total_soft_depot_expiring_time_penalty": 0,
"total_soft_depot_ready_time_penalty": 0,
"total_stop_count_penalty": 0,
"total_stops": 0,
"total_time_between_visits_penalty": 0,
"total_trailer_rolling_cost": 0,
"total_trailer_rolling_count": 0,
"total_trailer_transit_distance_m": 0,
"total_trailer_transit_duration_s": 0,
"total_transit_distance_cost": 0,
"total_transit_distance_m": 0,
"total_transit_duration_s": 0,
"total_transport_work_cost": 0,
"total_transport_work_tonne_km": 0,
"total_unfeasibility_count": 0,
"total_unfeasibility_penalty": 0,
"total_unique_stops": 0,
"total_waiting_duration_s": 0,
"total_walking_distance_m": 0,
"total_walking_duration_s": 0,
"total_walking_edge_distance_excess": 0,
"total_walking_edge_penalty": 0,
"total_work_breaks": 0,
"transit_time_penalty": 0,
"unfeasible_couple_coupled_trailer_penalty": 0,
"unfeasible_crossdock_missed_delivery_penalty": 0,
"unfeasible_decouple_decoupled_trailer_penalty": 0,
"unfeasible_decouple_unused_trailer_penalty": 0,
"unfeasible_depots_only_at_run_beginning_penalty": 0,
"unfeasible_empty_first_run_penalty": 0,
"unfeasible_failed_dependent_group_penalty": 0,
"unfeasible_failed_expiring_time_penalty": 0,
"unfeasible_failed_hard_time_window_penalty": 0,
"unfeasible_failed_lifo_order_penalty": 0,
"unfeasible_failed_ready_time_penalty": 0,
"unfeasible_failed_sequence_order_penalty": 0,
"unfeasible_failed_solid_group_penalty": 0,
"unfeasible_incompatible_load_types_penalty": 0,
"unfeasible_incompatible_zones_penalty": 0,
"unfeasible_invalid_pickup_delivery_order_penalty": 0,
"unfeasible_max_midde_depots_penalty": 0,
"unfeasible_missed_coupled_delivery_penalty": 0,
"unfeasible_missed_coupled_pickup_from_any_penalty": 0,
"unfeasible_missed_coupled_pickup_penalty": 0,
"unfeasible_missed_dependent_group_locations_penalty": 0,
"unfeasible_missed_planned_runs_penalty": 0,
"unfeasible_not_loaded_order_penalty": 0,
"unfeasible_not_same_depot_route_ending_penalty": 0,
"unfeasible_not_same_depot_run_ending_penalty": 0,
"unfeasible_pickup_missed_depot_penalty": 0,
"unfeasible_pickup_missed_drop_off_penalty": 0,
"unfeasible_planned_overload_penalty": 0,
"unfeasible_rolling_before_decoupling_penalty": 0,
"unfeasible_rolling_without_trailer_penalty": 0,
"unfeasible_shift_overtime_penalty": 0,
"unfeasible_trailer_diff_excess_penalty": 0,
"unfeasible_transit_time_excess_penalty": 0,
"unfeasible_unused_middle_depot_penalty": 0,
"unfeasible_use_trailer_prohibited_location_penalty": 0,
"unfeasible_vehicle_overload_penalty": 0,
"unfeasible_walking_after_route_end_penalty": 0,
"unfeasible_walking_courier_overload_penalty": 0,
"unfeasible_walking_to_depot_penalty": 0,
"unfeasible_work_break_drop_penalty": 0,
"used_vehicles": 0
},
"options": {
"absolute_time": false,
"avoid_tolls": false,
"avoid_zones": [
"string"
],
"balanced_groups": [
{
"id": "string",
"penalty": {
"custom_value": 0,
"hour": 0,
"ignore_unused_vehicles": false,
"km": 0,
"served_order": 0,
"stop": 0,
"unit": 0,
"weight_kg": 0
}
}
],
"close_location_groups_radius_m": 0,
"close_locations_during_post_optimization_only": false,
"critical_lateness_risk_probability": 20,
"date": "string",
"enable_vehicle_classes": true,
"fix_planned_shifts": false,
"force_merge_multiorders": false,
"global_proximity_factor": 0,
"ignore_min_stops_for_unused": false,
"ignore_zones": false,
"immutable": false,
"incompatible_load_types": [
[
"string"
]
],
"incompatible_zones": [
[
"string"
]
],
"load_when_ready": false,
"location_groups": [
{
"dependent": false,
"location_ids": [
0,
"string"
],
"solid": false,
"title": "string"
}
],
"matrix_router": "main",
"max_distance_to_projection_m": 1000000000,
"max_drop_penalty_percentage": 100,
"max_split_orders_percentage": 100,
"merge_multiorders": false,
"merge_multiorders_of_different_clients": true,
"minimize_lateness_risk": false,
"multiorder_radius_m": 1,
"penalize_late_service": false,
"points_throughputs": [
{
"throughput": {
"kg_per_hour": [
{
"time_window": "string",
"value": 0
}
],
"units_per_hour": [
{
"time_window": "string",
"value": 0
}
],
"vehicle_count": [
{
"time_window": "string",
"value": 0
}
]
},
"point": {
"lat": 0,
"lon": 0
},
"penalty": {
"throughput": {
"fixed": 1000,
"kg": 50,
"unit": 100,
"vehicle": 100000
}
}
}
],
"post_optimization": false,
"proximity_factor": 0,
"quality": "low",
"restart_on_drop": false,
"routing_mode": "driving",
"template_rest_schedules": [
{
"breaks": [
{
"after_last_location": false,
"at_rest_place": false,
"before_first_location": false,
"continuous_travel_time_range": "string",
"driving_time_range": "string",
"exact_time_range": "string",
"merge_with_types": [
"string"
],
"necessary_route_duration_s": 0,
"repeatable": false,
"rest_duration_s": 0,
"route_duration_s": 0,
"travel_time_range": "string",
"type": "string",
"work_time_range_from_start": "string",
"work_time_range_till_rest": "string",
"penalty": {
"late": {
"fixed": 1000,
"minute": 17
},
"early": {
"fixed": 1000,
"minute": 17
}
}
}
],
"id": "string"
}
],
"time_zone": 0,
"wait_in_multiorders": true,
"weighted_drop_penalty": false,
"penalty": {
"split_orders_percentage": {
"fixed": 1000,
"per_percent": 50
},
"multiorders": {
"per_extra_point": 0,
"per_extra_vehicle": 0,
"per_extra_visit": 0
},
"drop_penalty_percentage": {
"fixed": 1000,
"per_percent": 50
},
"close_location_groups": {
"per_extra_point": 0,
"per_extra_vehicle": 0,
"per_extra_visit": 0
}
}
},
"routes": [
{
"metrics": {
"arrival_after_start_penalty": 0,
"depot_throughput_violation_kg": 0,
"depot_throughput_violation_kg_per_hour": 0,
"depot_throughput_violation_units": 0,
"depot_throughput_violation_units_per_hour": 0,
"depot_throughput_violation_vehicles": 0,
"dropped_orders_units": 0,
"dropped_orders_volume_m3": 0,
"dropped_orders_weight_kg": 0,
"early_depot_count": 0,
"early_locations_count": 0,
"early_shifts_count": 0,
"empty_runs_penalty": 0,
"failed_dropped_breaks_count": 0,
"failed_dropped_breaks_duration_s": 0,
"failed_dropped_breaks_penalty": 0,
"failed_max_work_duration_count": 0,
"failed_min_work_duration_count": 0,
"failed_time_window_depot_count": 0,
"failed_time_window_depot_count_penalty": 0,
"failed_time_window_depot_duration_penalty": 0,
"failed_time_window_depot_duration_s": 0,
"failed_time_window_depots_total_penalty": 0,
"failed_time_window_locations_count": 0,
"failed_time_window_locations_count_penalty": 0,
"failed_time_window_locations_duration_penalty": 0,
"failed_time_window_locations_duration_s": 0,
"failed_time_window_locations_total_penalty": 0,
"failed_time_window_shifts_count": 0,
"failed_time_window_shifts_count_penalty": 0,
"failed_time_window_shifts_duration_penalty": 0,
"failed_time_window_shifts_duration_s": 0,
"failed_time_window_shifts_total_penalty": 0,
"failed_work_duration_count": 0,
"failed_work_duration_count_penalty": 0,
"failed_work_duration_penalty": 0,
"failed_work_duration_s": 0,
"failed_work_duration_total_penalty": 0,
"first_edges_penalty": 0,
"global_proximity": 0,
"last_edges_penalty": 0,
"late_depot_count": 0,
"late_locations_count": 0,
"late_shifts_count": 0,
"lateness_risk_locations_count": 0,
"max_distance_from_depot_m": 0,
"max_distance_to_attraction_point_m": 0,
"max_distance_to_garage_m": 0,
"new_global_proximity": 0,
"new_objective_minimum": 0,
"new_total_cost_with_penalty": 0,
"new_total_global_proximity_distance_m": 0,
"new_total_global_proximity_duration_s": 0,
"new_total_global_proximity_penalty": 0,
"new_total_guaranteed_penalty": 0,
"new_total_penalty": 0,
"new_total_stop_count_penalty": 0,
"new_total_stops": 0,
"objective_minimum": 0,
"old_global_proximity": 0,
"old_objective_minimum": 0,
"old_total_cost_with_penalty": 0,
"old_total_global_proximity_distance_m": 0,
"old_total_global_proximity_duration_s": 0,
"old_total_global_proximity_penalty": 0,
"old_total_guaranteed_penalty": 0,
"old_total_penalty": 0,
"old_total_stop_count_penalty": 0,
"old_total_stops": 0,
"overtime_duration_penalty": 0,
"overtime_duration_s": 0,
"overtime_penalty": 0,
"overtime_shifts_count": 0,
"overtime_shifts_count_penalty": 0,
"proximity": 0,
"route_custom_cost": 0,
"route_payout": 0,
"run_custom_cost": 0,
"run_payout": 0,
"shift_custom_cost": 0,
"shift_payout": 0,
"shift_total_custom_cost": 0,
"shift_total_payout": 0,
"total_cost": 0,
"total_cost_with_penalty": 0,
"total_custom_cost": 0,
"total_depot_penalty": 0,
"total_drop_penalty": 0,
"total_duration_cost": 0,
"total_duration_s": 0,
"total_early_count": 0,
"total_early_duration_s": 0,
"total_early_penalty": 0,
"total_empty_distance_m": 0,
"total_failed_delivery_deadline_count": 0,
"total_failed_delivery_deadline_duration_s": 0,
"total_failed_delivery_deadline_penalty": 0,
"total_failed_time_window_count": 0,
"total_failed_time_window_duration_s": 0,
"total_failed_time_window_penalty": 0,
"total_fails_penalty": 0,
"total_fixed_cost": 0,
"total_global_proximity_distance_m": 0,
"total_global_proximity_duration_s": 0,
"total_global_proximity_penalty": 0,
"total_guaranteed_penalty": 0,
"total_late_count": 0,
"total_late_duration_s": 0,
"total_late_penalty": 0,
"total_lateness_risk_probability": 0,
"total_locations_cost": 0,
"total_middle_depots": 0,
"total_mileage_penalty": 0,
"total_min_stop_weight_penalty": 0,
"total_multiorders_penalty": 0,
"total_non_empty_distance_m": 0,
"total_optional_tags_cost": 0,
"total_optional_zones_cost": 0,
"total_payout": 0,
"total_penalty": 0,
"total_probable_penalty": 0,
"total_proximity_distance_m": 0,
"total_proximity_duration_s": 0,
"total_proximity_penalty": 0,
"total_rest_duration_s": 0,
"total_runs_cost": 0,
"total_served_orders": 0,
"total_service_duration_s": 0,
"total_soft_depot_expiring_time_penalty": 0,
"total_soft_depot_ready_time_penalty": 0,
"total_stop_count_penalty": 0,
"total_stops": 0,
"total_trailer_rolling_cost": 0,
"total_trailer_rolling_count": 0,
"total_trailer_transit_distance_m": 0,
"total_trailer_transit_duration_s": 0,
"total_transit_distance_cost": 0,
"total_transit_distance_m": 0,
"total_transit_duration_s": 0,
"total_transport_work_cost": 0,
"total_transport_work_tonne_km": 0,
"total_unfeasibility_count": 0,
"total_unfeasibility_penalty": 0,
"total_unique_stops": 0,
"total_units": 0,
"total_volume_m3": 0,
"total_waiting_duration_s": 0,
"total_walking_distance_m": 0,
"total_walking_duration_s": 0,
"total_walking_edge_distance_excess": 0,
"total_walking_edge_penalty": 0,
"total_weight_kg": 0,
"total_work_breaks": 0,
"transit_time_penalty": 0,
"unfeasible_couple_coupled_trailer_penalty": 0,
"unfeasible_crossdock_missed_delivery_penalty": 0,
"unfeasible_decouple_decoupled_trailer_penalty": 0,
"unfeasible_decouple_unused_trailer_penalty": 0,
"unfeasible_depots_only_at_run_beginning_penalty": 0,
"unfeasible_empty_first_run_penalty": 0,
"unfeasible_failed_dependent_group_penalty": 0,
"unfeasible_failed_expiring_time_penalty": 0,
"unfeasible_failed_hard_time_window_penalty": 0,
"unfeasible_failed_lifo_order_penalty": 0,
"unfeasible_failed_ready_time_penalty": 0,
"unfeasible_failed_sequence_order_penalty": 0,
"unfeasible_failed_solid_group_penalty": 0,
"unfeasible_incompatible_load_types_penalty": 0,
"unfeasible_incompatible_zones_penalty": 0,
"unfeasible_invalid_pickup_delivery_order_penalty": 0,
"unfeasible_max_midde_depots_penalty": 0,
"unfeasible_missed_coupled_delivery_penalty": 0,
"unfeasible_missed_coupled_pickup_from_any_penalty": 0,
"unfeasible_missed_coupled_pickup_penalty": 0,
"unfeasible_missed_dependent_group_locations_penalty": 0,
"unfeasible_missed_planned_runs_penalty": 0,
"unfeasible_not_loaded_order_penalty": 0,
"unfeasible_not_same_depot_route_ending_penalty": 0,
"unfeasible_not_same_depot_run_ending_penalty": 0,
"unfeasible_pickup_missed_depot_penalty": 0,
"unfeasible_pickup_missed_drop_off_penalty": 0,
"unfeasible_planned_overload_penalty": 0,
"unfeasible_rolling_before_decoupling_penalty": 0,
"unfeasible_rolling_without_trailer_penalty": 0,
"unfeasible_shift_overtime_penalty": 0,
"unfeasible_trailer_diff_excess_penalty": 0,
"unfeasible_transit_time_excess_penalty": 0,
"unfeasible_unused_middle_depot_penalty": 0,
"unfeasible_use_trailer_prohibited_location_penalty": 0,
"unfeasible_vehicle_overload_penalty": 0,
"unfeasible_walking_after_route_end_penalty": 0,
"unfeasible_walking_courier_overload_penalty": 0,
"unfeasible_walking_to_depot_penalty": 0,
"unfeasible_work_break_drop_penalty": 0,
"utilization_units": 0,
"utilization_units_perc": 0,
"utilization_volume_m3": 0,
"utilization_volume_perc": 0,
"utilization_weight_kg": 0,
"utilization_weight_perc": 0
},
"route": [
{
"actual_arrival_time_s": 0,
"actual_departure_time_s": 0,
"actual_service_start_time_s": 0,
"actual_waiting_duration_s": 0,
"arrival_time_s": 0,
"departure_time_s": 0,
"load_to_head": [
0,
"string"
],
"load_to_trailer": [
0,
"string"
],
"multi_order": false,
"stop_sequence_number": 0,
"transit_distance_m": 0,
"transit_duration_s": 0,
"violations": [
{
"duration_s": 0,
"pickup_id": 0,
"type": "FAILED_DELIVERY_DEADLINE"
},
{
"duration_s": 0,
"high_risk": false,
"pickup_id": 0,
"probability": 0,
"type": "FAILED_DELIVERY_DEADLINE"
}
],
"waiting_duration_s": 0,
"probably_failed_time_window": {
"duration_s": 0,
"high_risk": false,
"how": "EARLY",
"probability": 0
},
"overtime": {
"duration_s": 0
},
"node": {
"type": "depot",
"used_hard_time_window": "string",
"used_time_window": "string",
"value": {
"actual_total_service_duration_s": 0,
"address": "string",
"crossdock_safety_waiting_duration_s": 3600,
"delivered_orders": [
0,
"string"
],
"description": "string",
"finish_service_duration_s": 0,
"fixed_position": false,
"flexible_start_time": false,
"hard_time_window": "string",
"hard_window": false,
"id": 0,
"load_service_duration_s": 0,
"loaded_orders": [
0,
"string"
],
"picked_orders": [
0,
"string"
],
"point": {
"lat": 0,
"lon": 0
},
"preliminary_service_duration_s": 0,
"preset_id": "string",
"ref": "string",
"routing_mode": "driving",
"service_duration_s": {
"fixed": 0,
"scaled": 0
},
"time_window": "string",
"time_windows": [
{
"hard_time_window": "string",
"time_window": "string"
}
],
"title": "string",
"total_service_duration_s": 0,
"trailer_decoupled": false,
"trailer_used": false,
"type": "depot",
"unfeasible_reasons": [
{
"late_duration_s": 0,
"text": "string",
"type": "FAILED_HARD_TIME_WINDOW"
},
{
"overrun_s": 0,
"text": "string",
"type": "TRANSIT_TIME_VIOLATION"
},
{
"text": "string",
"type": "OTHER"
}
],
"unload_service_duration_s": 0,
"use_in_proximity": false,
"time_windows_unloading": {
"hard_time_window": "string",
"hard_window": false,
"time_window": "string",
"time_windows": [
{
"hard_time_window": "string",
"time_window": "string"
}
],
"penalty": {
"out_of_time": {
"fixed": 1000,
"minute": 17
},
"late": {
"fixed": 1000,
"minute": 17
},
"early": {
"fixed": 1000,
"minute": 17
}
}
},
"time_windows_refilling": {
"hard_time_window": "string",
"hard_window": false,
"time_window": "string",
"time_windows": [
{
"hard_time_window": "string",
"time_window": "string"
}
],
"penalty": {
"out_of_time": {
"fixed": 1000,
"minute": 17
},
"late": {
"fixed": 1000,
"minute": 17
},
"early": {
"fixed": 1000,
"minute": 17
}
}
},
"time_windows_loading": {
"hard_time_window": "string",
"hard_window": false,
"time_window": "string",
"time_windows": [
{
"hard_time_window": "string",
"time_window": "string"
}
],
"penalty": {
"out_of_time": {
"fixed": 1000,
"minute": 17
},
"late": {
"fixed": 1000,
"minute": 17
},
"early": {
"fixed": 1000,
"minute": 17
}
}
},
"throughput": {
"kg_per_hour": [
{
"time_window": "string",
"value": 0
}
],
"units_per_hour": [
{
"time_window": "string",
"value": 0
}
],
"vehicle_count": [
{
"time_window": "string",
"value": 0
}
]
},
"penalty": {
"throughput": {
"fixed": 1000,
"kg": 50,
"unit": 100,
"vehicle": 100000
},
"package_throughput": {
"fixed": 1000,
"kg": 50,
"unit": 100
},
"out_of_time": {
"fixed": 1000,
"minute": 17
},
"late": {
"fixed": 1000,
"minute": 17
},
"early": {
"fixed": 1000,
"minute": 17
}
},
"package_throughput": {
"kg_per_hour": [
{
"time_window": "string",
"value": 0
}
],
"units_per_hour": [
{
"time_window": "string",
"value": 0
}
]
}
},
"used_projection": {
"lat": 0,
"lon": 0
}
},
"failed_time_window": {
"duration_s": 0,
"how": "EARLY"
}
}
],
"run_number": 0,
"vehicle_id": 0,
"shift": {
"balanced_group_id": "string",
"id": "string",
"start": {
"actual_arrival_time_s": 0,
"actual_departure_time_s": 0,
"actual_service_start_time_s": 0,
"actual_waiting_duration_s": 0,
"arrival_time_s": 0,
"departure_time_s": 0,
"load_to_head": [
0,
"string"
],
"load_to_trailer": [
0,
"string"
],
"multi_order": false,
"stop_sequence_number": 0,
"transit_distance_m": 0,
"transit_duration_s": 0,
"violations": [
{
"duration_s": 0,
"pickup_id": 0,
"type": "FAILED_DELIVERY_DEADLINE"
},
{
"duration_s": 0,
"high_risk": false,
"pickup_id": 0,
"probability": 0,
"type": "FAILED_DELIVERY_DEADLINE"
}
],
"waiting_duration_s": 0,
"probably_failed_time_window": {
"duration_s": 0,
"high_risk": false,
"how": "EARLY",
"probability": 0
},
"overtime": {
"duration_s": 0
},
"node": {
"type": "depot",
"used_hard_time_window": "string",
"used_time_window": "string",
"value": {
"actual_total_service_duration_s": 0,
"address": "string",
"crossdock_safety_waiting_duration_s": 3600,
"delivered_orders": [
0,
"string"
],
"description": "string",
"finish_service_duration_s": 0,
"fixed_position": false,
"flexible_start_time": false,
"hard_time_window": "string",
"hard_window": false,
"id": 0,
"load_service_duration_s": 0,
"loaded_orders": [
0,
"string"
],
"picked_orders": [
0,
"string"
],
"point": {
"lat": 0,
"lon": 0
},
"preliminary_service_duration_s": 0,
"preset_id": "string",
"ref": "string",
"routing_mode": "driving",
"service_duration_s": {
"fixed": 0,
"scaled": 0
},
"time_window": "string",
"time_windows": [
{
"hard_time_window": "string",
"time_window": "string"
}
],
"title": "string",
"total_service_duration_s": 0,
"trailer_decoupled": false,
"trailer_used": false,
"type": "depot",
"unfeasible_reasons": [
{
"late_duration_s": 0,
"text": "string",
"type": "FAILED_HARD_TIME_WINDOW"
},
{
"overrun_s": 0,
"text": "string",
"type": "TRANSIT_TIME_VIOLATION"
},
{
"text": "string",
"type": "OTHER"
}
],
"unload_service_duration_s": 0,
"use_in_proximity": false,
"time_windows_unloading": {
"hard_time_window": "string",
"hard_window": false,
"time_window": "string",
"time_windows": [
{
"hard_time_window": "string",
"time_window": "string"
}
],
"penalty": {
"out_of_time": {
"fixed": 1000,
"minute": 17
},
"late": {
"fixed": 1000,
"minute": 17
},
"early": {
"fixed": 1000,
"minute": 17
}
}
},
"time_windows_refilling": {
"hard_time_window": "string",
"hard_window": false,
"time_window": "string",
"time_windows": [
{
"hard_time_window": "string",
"time_window": "string"
}
],
"penalty": {
"out_of_time": {
"fixed": 1000,
"minute": 17
},
"late": {
"fixed": 1000,
"minute": 17
},
"early": {
"fixed": 1000,
"minute": 17
}
}
},
"time_windows_loading": {
"hard_time_window": "string",
"hard_window": false,
"time_window": "string",
"time_windows": [
{
"hard_time_window": "string",
"time_window": "string"
}
],
"penalty": {
"out_of_time": {
"fixed": 1000,
"minute": 17
},
"late": {
"fixed": 1000,
"minute": 17
},
"early": {
"fixed": 1000,
"minute": 17
}
}
},
"throughput": {
"kg_per_hour": [
{
"time_window": "string",
"value": 0
}
],
"units_per_hour": [
{
"time_window": "string",
"value": 0
}
],
"vehicle_count": [
{
"time_window": "string",
"value": 0
}
]
},
"penalty": {
"throughput": {
"fixed": 1000,
"kg": 50,
"unit": 100,
"vehicle": 100000
},
"package_throughput": {
"fixed": 1000,
"kg": 50,
"unit": 100
},
"out_of_time": {
"fixed": 1000,
"minute": 17
},
"late": {
"fixed": 1000,
"minute": 17
},
"early": {
"fixed": 1000,
"minute": 17
}
},
"package_throughput": {
"kg_per_hour": [
{
"time_window": "string",
"value": 0
}
],
"units_per_hour": [
{
"time_window": "string",
"value": 0
}
]
}
},
"used_projection": {
"lat": 0,
"lon": 0
}
},
"failed_time_window": {
"duration_s": 0,
"how": "EARLY"
}
},
"end": {
"actual_arrival_time_s": 0,
"actual_departure_time_s": 0,
"actual_service_start_time_s": 0,
"actual_waiting_duration_s": 0,
"arrival_time_s": 0,
"departure_time_s": 0,
"load_to_head": [
0,
"string"
],
"load_to_trailer": [
0,
"string"
],
"multi_order": false,
"stop_sequence_number": 0,
"transit_distance_m": 0,
"transit_duration_s": 0,
"violations": [
{
"duration_s": 0,
"pickup_id": 0,
"type": "FAILED_DELIVERY_DEADLINE"
},
{
"duration_s": 0,
"high_risk": false,
"pickup_id": 0,
"probability": 0,
"type": "FAILED_DELIVERY_DEADLINE"
}
],
"waiting_duration_s": 0,
"probably_failed_time_window": {
"duration_s": 0,
"high_risk": false,
"how": "EARLY",
"probability": 0
},
"overtime": {
"duration_s": 0
},
"node": {
"type": "depot",
"used_hard_time_window": "string",
"used_time_window": "string",
"value": {
"actual_total_service_duration_s": 0,
"address": "string",
"crossdock_safety_waiting_duration_s": 3600,
"delivered_orders": [
0,
"string"
],
"description": "string",
"finish_service_duration_s": 0,
"fixed_position": false,
"flexible_start_time": false,
"hard_time_window": "string",
"hard_window": false,
"id": 0,
"load_service_duration_s": 0,
"loaded_orders": [
0,
"string"
],
"picked_orders": [
0,
"string"
],
"point": {
"lat": 0,
"lon": 0
},
"preliminary_service_duration_s": 0,
"preset_id": "string",
"ref": "string",
"routing_mode": "driving",
"service_duration_s": {
"fixed": 0,
"scaled": 0
},
"time_window": "string",
"time_windows": [
{
"hard_time_window": "string",
"time_window": "string"
}
],
"title": "string",
"total_service_duration_s": 0,
"trailer_decoupled": false,
"trailer_used": false,
"type": "depot",
"unfeasible_reasons": [
{
"late_duration_s": 0,
"text": "string",
"type": "FAILED_HARD_TIME_WINDOW"
},
{
"overrun_s": 0,
"text": "string",
"type": "TRANSIT_TIME_VIOLATION"
},
{
"text": "string",
"type": "OTHER"
}
],
"unload_service_duration_s": 0,
"use_in_proximity": false,
"time_windows_unloading": {
"hard_time_window": "string",
"hard_window": false,
"time_window": "string",
"time_windows": [
{
"hard_time_window": "string",
"time_window": "string"
}
],
"penalty": {
"out_of_time": {
"fixed": 1000,
"minute": 17
},
"late": {
"fixed": 1000,
"minute": 17
},
"early": {
"fixed": 1000,
"minute": 17
}
}
},
"time_windows_refilling": {
"hard_time_window": "string",
"hard_window": false,
"time_window": "string",
"time_windows": [
{
"hard_time_window": "string",
"time_window": "string"
}
],
"penalty": {
"out_of_time": {
"fixed": 1000,
"minute": 17
},
"late": {
"fixed": 1000,
"minute": 17
},
"early": {
"fixed": 1000,
"minute": 17
}
}
},
"time_windows_loading": {
"hard_time_window": "string",
"hard_window": false,
"time_window": "string",
"time_windows": [
{
"hard_time_window": "string",
"time_window": "string"
}
],
"penalty": {
"out_of_time": {
"fixed": 1000,
"minute": 17
},
"late": {
"fixed": 1000,
"minute": 17
},
"early": {
"fixed": 1000,
"minute": 17
}
}
},
"throughput": {
"kg_per_hour": [
{
"time_window": "string",
"value": 0
}
],
"units_per_hour": [
{
"time_window": "string",
"value": 0
}
],
"vehicle_count": [
{
"time_window": "string",
"value": 0
}
]
},
"penalty": {
"throughput": {
"fixed": 1000,
"kg": 50,
"unit": 100,
"vehicle": 100000
},
"package_throughput": {
"fixed": 1000,
"kg": 50,
"unit": 100
},
"out_of_time": {
"fixed": 1000,
"minute": 17
},
"late": {
"fixed": 1000,
"minute": 17
},
"early": {
"fixed": 1000,
"minute": 17
}
},
"package_throughput": {
"kg_per_hour": [
{
"time_window": "string",
"value": 0
}
],
"units_per_hour": [
{
"time_window": "string",
"value": 0
}
]
}
},
"used_projection": {
"lat": 0,
"lon": 0
}
},
"failed_time_window": {
"duration_s": 0,
"how": "EARLY"
}
}
},
"global_proximity_attraction_point": {
"address": "string",
"allow_trailers": false,
"can_be_merged": true,
"can_be_split": false,
"client_id": 0,
"client_service_duration_s": {
"fixed": 0,
"scaled": 0
},
"comments": "string",
"crossdock_mode": "deny",
"crossdock_service_duration_s": {
"fixed": 0,
"scaled": 0
},
"custom_value": 0,
"delivery_deadline": "string",
"delivery_to": 0,
"delivery_to_any": [
0,
"string"
],
"depot_duration_s": {
"fixed": 0,
"scaled": 0
},
"depot_expiring_time": "string",
"depot_id": [
0,
"string"
],
"depot_ready_time": "string",
"description": "string",
"dropped_ratio": 0,
"hard_time_window": "string",
"hard_window": false,
"id": 0,
"ignore_zones_compatibility": false,
"in_lifo_order": false,
"load_types": [
"string"
],
"max_split_parts": 10,
"max_total_vehicles": 0,
"may_drop_in_crossdock": true,
"optional_tags": [
{
"tag": "string",
"value": 0
}
],
"parking_service_duration_s": 0,
"phone": "string",
"pickup_from_any": false,
"pickup_must_reach_depot": false,
"point": {
"lat": 0,
"lon": 0
},
"preset_id": "string",
"quant": 0,
"ref": "string",
"required_tags": [
"string"
],
"sequence_order": 0,
"service_duration_s": {
"fixed": 0,
"scaled": 0
},
"service_durations": {
"client": {
"fixed": 0,
"scaled": 0
},
"crossdock": {
"fixed": 0,
"scaled": 0
},
"depot": {
"fixed": 0,
"scaled": 0
},
"location": {
"fixed": 0,
"scaled": 0
},
"parking": 0,
"stop": {
"fixed": 0,
"scaled": 0
}
},
"shared_service_duration_s": {
"fixed": 0,
"scaled": 0
},
"shared_with_company_ids": [
0
],
"soft_depot_expiring_time": "string",
"soft_depot_ready_time": "string",
"split_parts_must_fill_whole_vehicle": false,
"time_window": "string",
"time_windows": [
{
"hard_time_window": "string",
"time_window": "string"
}
],
"title": "string",
"type": "depot",
"use_in_proximity": true,
"transit_time": {
"hard_limit_s": 0,
"limit_s": 0
},
"throughput": {
"kg_per_hour": [
{
"time_window": "string",
"value": 0
}
],
"units_per_hour": [
{
"time_window": "string",
"value": 0
}
],
"vehicle_count": [
{
"time_window": "string",
"value": 0
}
]
},
"shipment_size": {
"units": 0,
"volume_cbm": 0,
"weight_kg": 0,
"volume": {
"align": "all_axes",
"depth_m": 0,
"height_m": 0,
"type": "bulk",
"width_m": 0
},
"custom": 0
},
"rolling_throughput": {
"kg_per_hour": [
{
"time_window": "string",
"value": 0
}
],
"units_per_hour": [
{
"time_window": "string",
"value": 0
}
],
"vehicle_count": [
{
"time_window": "string",
"value": 0
}
]
},
"penalty": {
"drop": {
"fixed": 0,
"scaled": 1000000
},
"transit_time": {
"fixed": 0,
"minute": 0
},
"time_between_visits": {
"fixed": 1000,
"minute": 17
},
"throughput": {
"fixed": 1000,
"kg": 50,
"unit": 100,
"vehicle": 100000
},
"rolling_throughput": {
"fixed": 1000,
"kg": 50,
"unit": 100,
"vehicle": 100000
},
"out_of_time": {
"fixed": 1000,
"minute": 17
},
"late": {
"fixed": 1000,
"minute": 17
},
"early": {
"fixed": 1000,
"minute": 17
},
"depot_ready_time": {
"fixed": 1000,
"minute": 17
},
"depot_expiring_time": {
"fixed": 1000,
"minute": 17
},
"delivery_deadline": {
"fixed": 1000,
"minute": 17
}
}
}
}
],
"solver_status": "SOLVED",
"vehicles": [
{
"allow_different_depots_in_route": false,
"allowed_zones": [
"string"
],
"can_change_depot_between_runs": false,
"close_locations": [
{
"routing_mode": "driving",
"search_radius_m": 0,
"soft_search_radius_m": 0,
"duration_till_service_s": {
"penalty": 0,
"value": 1000000000
},
"distance_till_service_m": {
"penalty": 0,
"value": 1000000000
}
}
],
"cost": {
"fixed": 3000,
"hour": 100,
"km": 8,
"location": 0,
"run": 0,
"tonne_km": 0,
"waiting_hour": 0
},
"crossdock_mode": "deny",
"depot_extra_service_duration_s": 0,
"depot_id": [
0,
"string"
],
"depots_only_at_run_beginning": false,
"ending_depot_id": [
0,
"string"
],
"excluded_tags": [
"string"
],
"finish_at": 0,
"finish_route_in_starting_depot": false,
"finish_run_in_starting_depot": false,
"first_edges_penalty_factor": 0,
"fixed_planned_route": false,
"fixed_work_breaks": [
{
"shift_id": "string",
"work_duration_s": 0
}
],
"forbidden_zones": [
"string"
],
"global_proximity_attraction_point": 0,
"id": 0,
"imei": 0,
"immutable": false,
"incompatible_load_types": [
[
"string"
]
],
"incompatible_zones": [
[
"string"
]
],
"last_edges_penalty_factor": 0,
"max_middle_depots": 0,
"max_runs": 1,
"middle_depot_id": [
0,
"string"
],
"min_stop_weight": 0,
"onboard_incompatible_load_types": false,
"optional_zones": [
{
"value": 0,
"zone": "string"
}
],
"payout": "string",
"phone": "string",
"preset_id": "string",
"ref": "string",
"rest_schedule_id": "string",
"return_to_depot": true,
"routing_mode": "driving",
"service_duration_multiplier": 1,
"shared_service_duration_multiplier": 1,
"shifts": [
{
"balanced_group_id": "string",
"hard_max_duration_s": 2592000,
"hard_time_window": "string",
"hard_window": false,
"id": "string",
"immutable": false,
"max_duration_s": 172800,
"max_mileage_km": 0,
"max_runs": 1,
"maximal_stops": 0,
"minimal_stops": 0,
"minimal_unique_stops": 0,
"preset_id": "string",
"service_duration_s": 0,
"time_window": "string",
"penalty": {
"unique_stop_lack": {
"fixed": 0,
"per_stop": 0
},
"stop_lack": {
"fixed": 0,
"per_stop": 0
},
"stop_excess": {
"fixed": 0,
"per_stop": 0
},
"out_of_time": {
"fixed": 1000,
"minute": 17
},
"max_mileage": {
"fixed": 1000,
"km": 100
},
"late": {
"fixed": 1000,
"minute": 17
},
"early": {
"fixed": 1000,
"minute": 17
}
}
}
],
"start_at": 0,
"starting_depot_id": [
0,
"string"
],
"tags": [
"string"
],
"travel_time_multiplier": 1,
"visit_depot_at_start": true,
"visited_locations": [
{
"delivered_orders": [
0,
"string"
],
"id": 0,
"order_ratio": 0,
"shift_id": "string",
"time": "string",
"wait_if_early": true
}
],
"walking_courier": {
"restrictions": {
"max_walking_edge_distance_m": {
"penalty": 0,
"value": 1000000000
},
"max_parking_walking_distance_m": {
"penalty": 0,
"value": 1000000000
},
"max_parking_duration_s": {
"penalty": 0,
"value": 1000000000
}
},
"cost": {
"hour": 0,
"km": 0
},
"capacity": {
"units": 1000000000
}
},
"trailer": {
"coupling_time_s": 0,
"decoupling_time_s": 0,
"rolling_cost": 0,
"rolling_time": {
"fixed_time_s": 0,
"s_per_kg": 0,
"s_per_m3": 0,
"s_per_unit": 0
},
"max_capacity_difference": {
"units": 0,
"volume_cbm": 0,
"weight_kg": 0,
"custom": 0
},
"cost": {
"fixed": 3000,
"hour": 100,
"km": 8,
"location": 0,
"run": 0,
"tonne_km": 0,
"waiting_hour": 0
},
"capacity": {
"units": 1000000000,
"volume_cbm": 0,
"weight_kg": 1000000000,
"volume": {
"depth_m": 1000,
"height_m": 1000,
"width_m": 1000
},
"limits": {
"units_perc": 100,
"volume_perc": 100,
"weight_perc": 100
},
"custom": 0
}
},
"specs": {
"height": 0,
"length": 0,
"max_weight": 0,
"max_weight_kg": 0,
"width": 0
},
"rest_schedule": {
"breaks": [
{
"after_last_location": false,
"at_rest_place": false,
"before_first_location": false,
"continuous_travel_time_range": "string",
"driving_time_range": "string",
"exact_time_range": "string",
"merge_with_types": [
"string"
],
"necessary_route_duration_s": 0,
"repeatable": false,
"rest_duration_s": 0,
"route_duration_s": 0,
"travel_time_range": "string",
"type": "string",
"work_time_range_from_start": "string",
"work_time_range_till_rest": "string",
"penalty": {
"late": {
"fixed": 1000,
"minute": 17
},
"early": {
"fixed": 1000,
"minute": 17
}
}
}
]
},
"planned_route": {
"locations": [
{
"anchor_mode": "Decoupling",
"delivered_orders": [
0,
"string"
],
"delivery_in_current_run": false,
"id": 0,
"is_middle_depot": false,
"loaded_orders": [
0,
"string"
],
"order_ratio": 0,
"parking_mode": "ParkingBegin",
"picked_orders": [
0,
"string"
],
"shift_id": "string",
"wait_if_early": true
}
],
"planned_runs_first": false,
"start_time": "string",
"work_breaks": [
{
"shift_id": "string",
"work_duration_s": 0
}
]
},
"penalty": {
"min_stop_weight": {
"fixed": 1000,
"kg": 50
},
"empty_runs": {
"fixed": 0,
"per_run": 0
},
"arrival_after_start": {
"as_soon_as_possible": false,
"average_h": 0
}
},
"capacity": {
"units": 1000000000,
"volume_cbm": 0,
"weight_kg": 1000000000,
"volume": {
"depth_m": 1000,
"height_m": 1000,
"width_m": 1000
},
"limits": {
"units_perc": 100,
"volume_perc": 100,
"weight_perc": 100
},
"custom": 0
}
}
],
"zones": [
{
"id": "string",
"geometry": {
"coordinates": [
[
[
0
]
]
],
"type": "string"
}
}
]
},
"error": {
"incident_id": "string",
"message": "string"
},
"id": "string",
"message": "string",
"status": {
"cancelled": 0,
"completed": 0,
"estimate": 0,
"queued": 0,
"started": 0
}
}
Name |
Description |
error* |
Type: error_2_error Error description. |
id* |
Type: string Task unique id. |
result* |
Type: mvrp_response MVRP solver response. |
status* |
Type: task_info_1_status Task statuses object. Keys are task statuses, values are UNIX timestamps for corresponding status. Possible status transits:
|
message |
Type: string Human-readable description of task state. |
error_2_error
Error description.
Name |
Description |
message* |
Type: string Human-readable error description. |
incident_id |
Type: string Unique identifier of error incident. In case of API error, this identifier can be provided to support for investigation. |
mvrp_response
MVRP solver response.
Name |
Description |
dropped_locations* |
Type: mvrp_response_dropped_locations_item[] List of locations excluded (dropped) from route due to vehicle shortage or another constraint violation. |
metrics* |
Type: solution_metrics_1 Metrics for a solution. |
options* |
Type: solver_options_1 Solver options. It is forbidden to specify options that are not present in the list below. |
routes* |
Type: mvrp_response_routes_item[] List of routes and individual metrics for each route. |
solver_status* |
Type: string Status of routing solver:
Enum: |
vehicles* |
Type: vehicle[] List of vehicles, available for route planning. Min items: |
detailed_cost_metrics |
Type: detailed_cost_1[] The value of an arbitrary cost. |
zones |
Type: mvrp_response_zones_item[] |
task_info_1_status
Task statuses object. Keys are task statuses, values are UNIX timestamps for corresponding status.
Possible status transits:
queued
-> started
-> (completed
or cancelled
)
Name |
Description |
queued* |
Type: number Task has been queued for execution. |
cancelled |
Type: number Task execution has been cancelled by user or system due to timeout or error. |
completed |
Type: number Task execution completed with result or error. |
estimate |
Type: number Estimated time when task expected to be completed. The time estimation may change during solving process. The estimate is valid for approximately 75% of tasks (they may be ready 5-15 seconds before "estimate")Some tasks may require more time for calculation, typically this extra time is not more than 1 minute. |
started |
Type: number Task execution has been started. |
mvrp_response_dropped_locations_item
Location of order to deliver from depot.
Name |
Description |
drop_reason* |
Type: string Explanation why the location was dropped. |
id* |
Type: integer or string Location ID. All locations IDs in task must be unique and have the same type: integer or string. More information |
point* |
Type: coordinate_2 WGS84 coordinate of a location. More information |
address |
Type: string Address of the location. |
allow_trailers |
Type: boolean When |
can_be_merged |
Type: boolean An order can be a part of multiorder Default: |
can_be_split |
Type: boolean An order can be split into parts between different vehicles. |
client_id |
Type: integer or string Defines |
client_service_duration_s |
Type: client_service_duration_0 or number Duration of service at a location, which can be shared among the other orders of the same client (by client_id) at exactly the same location. |
comments |
Type: string Comments. |
crossdock_mode |
Type: string Defines whether it is allowed to deliver this order through a cross-dock depot.
Default: Enum: |
crossdock_service_duration_s |
Type: crossdock_service_duration_0 or number Time spent at a crossdock location during the unloading of this order. More information |
custom_value |
Type: number A custom numeric value, associated with location (E.g. the reward for the courier for visiting this location). May be used as a component in vehicle cost function. |
delivery_deadline |
Type: string Time by which the |
delivery_to |
Type: integer or string Defines |
delivery_to_any |
Type: (integer or string)[] A list of |
depot_duration_s |
Type: depot_duration_0 or number Time spent at a depot during handling of this location (goods loading, document collection, etc.). More information |
depot_expiring_time |
Type: string Time by which the order must be taken from the depot, in |
depot_id |
Type: integer or string or array |
depot_ready_time |
Type: string Time when the order is ready to be taken from any depot, in |
description |
Type: string Location description. |
dropped_ratio |
Type: number Order ratio which have to stay in drop Max value: |
hard_time_window |
Type: string Allowed hard time window to visit location, in |
hard_window |
Type: boolean Restricts time window relaxation during route planning. If location cannot be visited within a specified time window, it will be excluded from the route and added to |
ignore_zones_compatibility |
Type: boolean Ignore the effects caused by the |
in_lifo_order |
Type: boolean Orders with this field set to |
load_types |
Type: string[] Defines types of location load.
mustn |
max_split_parts |
Type: integer Maximal number of parts in which the order can be split Default: Min value: |
max_total_vehicles |
Type: integer Maximal number of vehicles that can be served by an anchor location. Unlimited by default. More information |
may_drop_in_crossdock |
Type: boolean May drop pickup order in crossdock location Default: |
optional_tags |
Type: mvrp_response_dropped_locations_optional_tags_item[] List of tags which are not required for a vehicle to serve the location, but they can decrease or increase the route cost if satisfied. More information |
parking_service_duration_s |
Type: number Duration of parking at location. If the order is delivered using Max value: |
penalty |
Type: mvrp_response_dropped_locations_penalty Penalties for non-completion and time window failure. More information |
phone |
Type: string Phone number of delivery receiver. |
pickup_from_any |
Type: boolean Delivery-orders that have this field set to |
pickup_id |
Type: integer or string ID of a pickup corresponding to this delivery. |
pickup_must_reach_depot |
Type: boolean The field determines whether the pickup is considered serviced if it is not delivered depot. The field shouldnt be defined for types other than pickup. The field is mutually exclusive with fields |
preset_id |
Type: string Preset number for location properties. |
quant |
Type: number or dropped_locations_quant_0_1 |
ref |
Type: string Location reference. |
required_tags |
Type: string[] List of tags a vehicle must have to arrive at the location. More information |
rolling_throughput |
Type: mvrp_response_dropped_locations_rolling_throughput Rolling throughput limit (supported for anchors). |
sequence_order |
Type: integer All locations in vehicle route with specified sequence_order option have to be visited in non-decreasing order of its values. More information |
service_duration_s |
Type: service_duration_2_0 or number Duration of service at location. Service duration can include any operations at location, such as loading or unloading items from a vehicle, or any other time associated with a location (apart from waiting, which is time after arrival and before service).More information |
service_durations |
Type: service_durations Structure storing location service durations. |
shared_service_duration_s |
Type: shared_service_duration_0 or number Duration of service at a location, which can be shared among the other orders at exactly the same location. Shared service duration can include such operations as parking of a car, delivering documents, etc. More information |
shared_with_company_ids |
Type: integer[] IDs of the companies that can access the order information. |
shipment_size |
Type: mvrp_response_dropped_locations_shipment_size Shipment size (dimensions and/or weight). More information |
soft_depot_expiring_time |
Type: string Time by which the order must be taken from the depot, in |
soft_depot_ready_time |
Type: string Time when the order is ready to be taken from any depot, in |
split_info |
Type: mvrp_response_dropped_locations_split_info Information about split part of the order (in case if the order was split) |
split_parts_must_fill_whole_vehicle |
Type: boolean Parts, split from a splittable order, should fill the whole vehicle. |
throughput |
Type: mvrp_response_dropped_locations_throughput Location throughput limit (supported for the orders which can be split). |
time_window |
Type: string Allowed time window to visit location, in |
time_windows |
Type: mvrp_response_dropped_locations_time_windows_item[] List of allowed time windows. Time windows can not overlap. Fields |
title |
Type: string Location title. |
transit_time |
Type: mvrp_response_dropped_locations_transit_time Restrictions on the time the order spends inside a vehicle |
type |
Type: string Defines a type of service at the location:
Default: Enum: |
use_in_proximity |
Type: boolean When Default: |
solution_metrics_1
Metrics for a solution.
Name |
Description |
arrival_after_start_penalty* |
Type: number Penalty for arrived after start of timewindow |
depot_throughput_violation_kg* |
Type: number Total violation of depot throughput, kilograms. |
depot_throughput_violation_kg_per_hour* |
Type: number Total violation of depot throughput, kilograms per hour (deprecated). |
depot_throughput_violation_units* |
Type: number Total violation of depot throughput, units. |
depot_throughput_violation_units_per_hour* |
Type: number Total violation of depot throughput, units per hour (deprecated). |
depot_throughput_violation_vehicles* |
Type: number Total violation of depot throughput, vehicles. |
drop_penalty_percentage* |
Type: number Relation of total_drop_penalty to the maximal possible drop penalty. |
dropped_locations_count* |
Type: integer |
early_depot_count* |
Type: integer Number of arrivals to a depot earlier than the specified time window. |
early_locations_count* |
Type: integer Number of locations where arrival will happen earlier than the picked time window. |
early_shifts_count* |
Type: integer Number of shifts where arrival will happen earlier than the specified time window. |
empty_runs_penalty* |
Type: number Penalty for empty runs, which cannot be skipped because of actual visit times. |
failed_dropped_breaks_count* |
Type: integer Number of work breaks that are not used in the route, although they should be. |
failed_dropped_breaks_duration_s* |
Type: number Total duration of failures for work breaks that are not used in the route, although they should be, seconds. |
failed_dropped_breaks_penalty* |
Type: number Sum of penalties for work breaks that are not used in the route, although they should be. |
failed_max_work_duration_count* |
Type: integer Number of continuous work time intervals which violate specified maximal work duration. |
failed_min_work_duration_count* |
Type: integer Number of continuous work time intervals which violate specified minimal work duration. |
failed_time_window_depot_count* |
Type: integer Number of arrivals to a depot outside of the time window. |
failed_time_window_depot_count_penalty* |
Type: number Sum of fixed penalties applied for violations of depot time windows. |
failed_time_window_depot_duration_penalty* |
Type: number Sum of per minute penalties applied for violations of depot time windows. |
failed_time_window_depot_duration_s* |
Type: number Total duration of depot time window fails, seconds. |
failed_time_window_depots_total_penalty* |
Type: number Total cost for depot time window fails. |
failed_time_window_locations_count* |
Type: integer Number of locations where arrival will happen outside of the time window. |
failed_time_window_locations_count_penalty* |
Type: number Sum of fixed penalties applied for arriving at order location out of the time window. |
failed_time_window_locations_duration_penalty* |
Type: number Sum of per minute penalties applied for arriving at location out of the time window. |
failed_time_window_locations_duration_s* |
Type: number Total duration of location time window fails, seconds. |
failed_time_window_locations_total_penalty* |
Type: number Total cost for location time window fails. |
failed_time_window_shifts_count* |
Type: integer Number of shifts where arrival will happen outside of the time window. |
failed_time_window_shifts_count_penalty* |
Type: number Sum of fixed penalties applied for violations of shift time windows. |
failed_time_window_shifts_duration_penalty* |
Type: number Sum of per minute penalties applied for violations of shift time windows. |
failed_time_window_shifts_duration_s* |
Type: number Total duration of shift time window fails, seconds. |
failed_time_window_shifts_total_penalty* |
Type: number Total cost for shift time window fails. |
failed_work_duration_count* |
Type: integer Number of continuous work time intervals which violate specified minimal or maximal work duration. |
failed_work_duration_count_penalty* |
Type: number Sum of fixed penalties applied for failures of continuous work duration minimal or maximal limits. |
failed_work_duration_penalty* |
Type: number Sum of per minute penalties applied for failures of continuous work duration. |
failed_work_duration_s* |
Type: number Total duration of continuous work time interval failures, seconds. |
failed_work_duration_total_penalty* |
Type: number Total cost for continuous work time interval failures. |
first_edges_penalty* |
Type: number The total penalty for the first edge of every run |
global_proximity* |
Type: number Global proximity level of route(s): average possible distance from the last location in route, kilometers. |
last_edges_penalty* |
Type: number The total penalty for the last edge of every run |
late_depot_count* |
Type: integer Number of arrivals to a depot later than the specified time window. |
late_locations_count* |
Type: integer Number of locations where arrival will happen later than the picked time window. |
late_shifts_count* |
Type: integer Number of shifts where arrival will happen later than the specified time window. |
lateness_risk_locations_count* |
Type: integer Number of locations and deadlines with a risk of late arrival. |
max_distance_from_depot_m* |
Type: number Maximal distance from order location to the depot. |
max_distance_to_attraction_point_m* |
Type: number Maximal distance from order location to the global_proximity_attraction_point. |
max_distance_to_garage_m* |
Type: number Maximal distance from order location to the depot. |
max_drop_percentage_penalty* |
Type: number Penalty for max_drop_penalty_percentage violation. |
number_of_routes* |
Type: integer Total number of vehicle routes. |
objective_minimum* |
Type: number Minimum of optimization objective. |
optimization_steps* |
Type: integer Number of solver optimization steps. |
overtime_duration_penalty* |
Type: number Sum of per minute penalties applied for violating of maximal shift duration. |
overtime_duration_s* |
Type: number Total shift overtime duration in seconds. |
overtime_penalty* |
Type: number Sum of penalties applied for violating of maximal shift duration. |
overtime_shifts_count* |
Type: integer Number of shifts where duration is more than |
overtime_shifts_count_penalty* |
Type: number Sum of fixed penalties applied for violating of maximal shift duration. |
proximity* |
Type: number Proximity level of route(s): average possible distance between two locations en route, kilometers. |
total_cost* |
Type: number Total of all expenses. |
total_cost_with_penalty* |
Type: number Total expectation of all expenses including guaranteed and probable penalties. |
total_drop_penalty* |
Type: number Sum of dropped locations penalties per drop. |
total_duration_cost* |
Type: number Total of all used vehicles costs per duration of usage. |
total_duration_s* |
Type: number Total duration including transit, service and waiting time, seconds. |
total_early_count* |
Type: integer Total number of arrivals earlier than the picked time window. |
total_early_duration_s* |
Type: number Total duration of early arrivals, sum of (start of the time window) - (arrival time), seconds. |
total_early_penalty* |
Type: number Sum of penalties applied for arriving and serving at location earlier than the picked time window. |
total_empty_distance_m* |
Type: number Total distance traveled without any orders in vehicle. |
total_failed_delivery_deadline_count* |
Type: number Total number of failed deadlines. |
total_failed_delivery_deadline_duration_s* |
Type: number Total duration of deadlines fails, seconds. |
total_failed_delivery_deadline_penalty* |
Type: number Sum of penalties applied for arriving and serving at depot after the deadline. |
total_failed_time_window_count* |
Type: integer Total number of time window fails (sum of |
total_failed_time_window_duration_s* |
Type: number Total duration of time window fails (sum of |
total_failed_time_window_penalty* |
Type: number Sum of penalties applied for being out of the time window at location, shift or depot. |
total_fails_penalty* |
Type: number Sum of fails penalties |
total_fixed_cost* |
Type: number Total of all used vehicles fixed costs. |
total_global_proximity_distance_m* |
Type: number Total global proximity distance, meters. |
total_global_proximity_duration_s* |
Type: number Total global proximity duration, seconds. |
total_global_proximity_penalty* |
Type: number Sum of global proximity penalties. |
total_guaranteed_penalty* |
Type: number Total of all guaranteed penalties. |
total_late_count* |
Type: integer Total number of arrivals later than the picked time window. |
total_late_duration_s* |
Type: number Total duration of late arrivals, sum of (arrival time) - (end of the time window), seconds. |
total_late_penalty* |
Type: number Sum of penalties applied for arriving and serving at location later than the picked time window. |
total_lateness_risk_probability* |
Type: number Sum of all probabilities of being late on locations and deadlines. |
total_locations_cost* |
Type: number Total of all used vehicles costs per location. |
total_middle_depots* |
Type: integer Number of middle depots. |
total_mileage_penalty* |
Type: number Total penalties applied for mileage limit violation. |
total_min_stop_weight_penalty* |
Type: number Total penalties applied for min_stop_weight violation. |
total_non_empty_distance_m* |
Type: number Total distance traveled with at least one order in vehicle. |
total_optional_tags_cost* |
Type: number The value added to the total cost by optional tags. |
total_optional_zones_cost* |
Type: number The value added to the total cost by optional zones. |
total_penalty* |
Type: number Sum of guaranteed and probable penalties. |
total_probable_penalty* |
Type: number Expected total of all probable penalties. |
total_proximity_distance_m* |
Type: number Total proximity distance, meters. |
total_proximity_duration_s* |
Type: number Total proximity duration, seconds. |
total_proximity_penalty* |
Type: number Sum of proximity penalties. |
total_rest_duration_s* |
Type: number Total duration of work breaks, seconds |
total_runs_cost* |
Type: number Total of all used vehicles costs per run. |
total_served_orders* |
Type: number The total number of orders served. |
total_service_duration_s* |
Type: number Total duration of service at locations, seconds |
total_soft_depot_expiring_time_penalty* |
Type: number Total penalty for violating the soft_depot_expiring_time |
total_soft_depot_ready_time_penalty* |
Type: number Total penalty for violating the soft_depot_ready_time |
total_stop_count_penalty* |
Type: number Total penalties applied for stop count limit violation. |
total_stops* |
Type: integer Number of vehicle stops - different sequential order locations en route. |
total_trailer_rolling_cost* |
Type: number Total penalty for rolling goods from the trailer to the head. |
total_trailer_rolling_count* |
Type: number Total number of rollings of goods from the trailer to the head. |
total_trailer_transit_distance_m* |
Type: number Total transit distance with the coupled trailer, meters. |
total_trailer_transit_duration_s* |
Type: number Total transit with the coupled trailer duration (driving duration), seconds. |
total_transit_distance_cost* |
Type: number Total of all used vehicles costs per transit distance. |
total_transit_distance_m* |
Type: number Total transit distance, meters. If |
total_transit_duration_s* |
Type: number Total transit duration (driving duration), seconds. |
total_transport_work_cost* |
Type: number Total transport work cost (transport cost for each vehicle is taken with specified weight). |
total_transport_work_tonne_km* |
Type: number Total transport work (product of cargo weight and route length), tonne-km. |
total_unfeasibility_count* |
Type: number Number of locations which violate strict constraints but cannot be dropped. |
total_unfeasibility_penalty* |
Type: number Sum of location drop penalties applied for locations which violate strict constraints but cannot be dropped. |
total_unique_stops* |
Type: integer Number of vehicle stops with unique coordinates excluding depots and garages |
total_waiting_duration_s* |
Type: number Total duration of waiting at locations before travel to other locations or the start of the time window, seconds. |
total_walking_distance_m* |
Type: number Total walking distance of the |
total_walking_duration_s* |
Type: number Total walking duration of the |
total_walking_edge_distance_excess* |
Type: number Total excess of the allowed maximum length of walking edges. |
total_walking_edge_penalty* |
Type: number Total penalty for exceeding the maximum length of walking edges. |
total_work_breaks* |
Type: integer Total number of work breaks. |
transit_time_penalty* |
Type: number Penalty for transit time violation. |
used_vehicles* |
Type: integer Number of vehicles used in solution. |
assigned_locations_count |
Type: integer Total number of assigned to vehicles locations. |
balanced_group_custom_value_deviation |
Type: number Total root-sum-square deviation of balanced group route |
balanced_group_distance_deviation_m |
Type: number Total root-sum-square deviation of balanced group route distance from averages. |
balanced_group_duration_deviation_s |
Type: number Total root-sum-square deviation of balanced group route durations from averages. |
balanced_group_kg_deviation |
Type: number Total root-sum-square deviation of balanced group route locations weight in kilograms from averages. |
balanced_group_penalty |
Type: number Total penalty for imbalanced routes. |
balanced_group_served_order_count_deviation |
Type: number Total root-sum-square deviation of balanced group route served order count from averages. |
balanced_group_stop_count_deviation |
Type: number Total root-sum-square deviation of balanced group route stop counts from averages. |
balanced_group_unit_deviation |
Type: number Total root-sum-square deviation of balanced group route locations weight in units from averages. |
close_location_groups_extra_points |
Type: integer Number of points in close location groups to which vehicles/couriers arrived more than once. |
close_location_groups_extra_vehicles |
Type: integer Number of situations when several different vehicles/couriers arrive at points in close location groups. |
close_location_groups_extra_visits |
Type: integer Number of extra visits to points in close location groups. |
close_location_groups_penalty |
Type: integer Total penalty for close location groups |
intermediate_location_distance_threshold_m |
Type: number Distance threshold for intermediate locations Default: |
intermediate_location_duration_threshold_s |
Type: number Duration threshold for intermediate locations Default: |
max_split_orders_percentage_penalty |
Type: number Penalty for max_split_orders_percentage violation. |
max_vehicle_runs |
Type: integer Maximal number of a single vehicle runs. |
multiorders_extra_points |
Type: integer Number of points with multi-orders to which vehicles/couriers arrived more than once. |
multiorders_extra_vehicles |
Type: integer Number of situations when several different vehicles/couriers arrive at points with multi-orders. |
multiorders_extra_visits |
Type: integer Number of extra visits to points with multi-orders. |
new_balanced_group_custom_value_deviation |
Type: number New value of balanced_group_custom_value_deviation metric after post optimization. |
new_balanced_group_distance_deviation_m |
Type: number New value of balanced_group_distance_deviation_m metric after post optimization. |
new_balanced_group_duration_deviation_s |
Type: number New value of balanced_group_duration_deviation_s metric after post optimization. |
new_balanced_group_kg_deviation |
Type: number New value of balanced_group_kg_deviation metric after post optimization. |
new_balanced_group_penalty |
Type: number New value of balanced_group_penalty metric after post optimization. |
new_balanced_group_served_order_count_deviation |
Type: number New value of balanced_group_served_order_count_deviation metric after post optimization. |
new_balanced_group_stop_count_deviation |
Type: number New value of balanced_group_stop_count_deviation metric after post optimization. |
new_balanced_group_unit_deviation |
Type: number New value of balanced_group_unit_deviation metric after post optimization. |
new_global_proximity |
Type: number New value of global_proximity metric after post optimization. |
new_objective_minimum |
Type: number New value of objective_minimum metric after post optimization. |
new_total_cost_with_penalty |
Type: number New value of total_cost_with_penalty metric after post optimization. |
new_total_global_proximity_distance_m |
Type: number New value of total_global_proximity_distance_m metric after post optimization. |
new_total_global_proximity_duration_s |
Type: number New value of total_global_proximity_duration_s metric after post optimization. |
new_total_global_proximity_penalty |
Type: number New value of total_global_proximity_penalty metric after post optimization. |
new_total_guaranteed_penalty |
Type: number New value of total_guaranteed_penalty metric after post optimization. |
new_total_penalty |
Type: number New value of total_penalty metric after post optimization. |
new_total_stop_count_penalty |
Type: number New value of total_stop_count_penalty metric after post optimization. |
new_total_stops |
Type: integer New value of total_stops metric after post optimization. |
old_balanced_group_custom_value_deviation |
Type: number Old value of balanced_group_custom_value_deviation metric after post optimization. |
old_balanced_group_distance_deviation_m |
Type: number Old value of balanced_group_distance_deviation_m metric after post optimization. |
old_balanced_group_duration_deviation_s |
Type: number Old value of balanced_group_duration_deviation_s metric after post optimization. |
old_balanced_group_kg_deviation |
Type: number Old value of balanced_group_kg_deviation metric after post optimization. |
old_balanced_group_penalty |
Type: number Old value of balanced_group_penalty metric after post optimization. |
old_balanced_group_served_order_count_deviation |
Type: number Old value of balanced_group_served_order_count_deviation metric after post optimization. |
old_balanced_group_stop_count_deviation |
Type: number Old value of balanced_group_stop_count_deviation metric after post optimization. |
old_balanced_group_unit_deviation |
Type: number Old value of balanced_group_unit_deviation metric after post optimization. |
old_global_proximity |
Type: number Old value of global_proximity metric after post optimization. |
old_objective_minimum |
Type: number Old value of objective_minimum metric after post optimization. |
old_total_cost_with_penalty |
Type: number Old value of total_cost_with_penalty metric after post optimization. |
old_total_global_proximity_distance_m |
Type: number Old value of total_global_proximity_distance_m metric after post optimization. |
old_total_global_proximity_duration_s |
Type: number Old value of total_global_proximity_duration_s metric after post optimization. |
old_total_global_proximity_penalty |
Type: number Old value of total_global_proximity_penalty metric after post optimization. |
old_total_guaranteed_penalty |
Type: number Old value of total_guaranteed_penalty metric after post optimization. |
old_total_penalty |
Type: number Old value of total_penalty metric after post optimization. |
old_total_stop_count_penalty |
Type: number Old value of total_stop_count_penalty metric after post optimization. |
old_total_stops |
Type: integer Old value of total_stops metric after post optimization. |
operations_per_second |
Type: number Solver speed, number of operations per second. |
route_custom_cost |
Type: number Cost of custom defined expenses for route. For vehicles, the entire cost placed in metrics of route first run. |
route_payout |
Type: number Payout to courier of custom defined expenses for route. For vehicles, the entire payout placed in metrics of route first run. |
run_custom_cost |
Type: number Cost of custom defined expenses for run. |
run_payout |
Type: number Payout to courier of custom defined expenses for run. |
shift_custom_cost |
Type: number Cost of custom defined expenses for shift. For vehicles, the entire cost placed in metrics of shift first run. |
shift_payout |
Type: number Payout to courier of custom defined expenses for shift. For vehicles, the entire payout placed in metrics of shift first run. |
shift_total_custom_cost |
Type: number Total cost of custom defined expenses for shift. Includes cost of the shift and the cost of runs included in the shift. For vehicles, the entire cost placed in metrics of shift first run. |
shift_total_payout |
Type: number Total payout to courier of custom defined expenses for shift. Includes payout of the shift and the payout of runs included in the shift. For vehicles, the entire payout placed in metrics of shift first run. |
skip_intermediate_location_penalty |
Type: number The total penalty skip intermediate location |
split_orders_percentage |
Type: number Percentage of orders which were split. |
total_custom_cost |
Type: number Total cost of all custom defined expenses. Includes expenses for the route, shifts and runs. For vehicles, the entire route cost placed in metrics of first run. |
total_depot_penalty |
Type: number Sum of depot penalties. |
total_failed_time_between_visits_count |
Type: integer Total number of violations of the |
total_failed_time_between_visits_duration_s |
Type: number Total duration of violations of the |
total_multiorders_penalty |
Type: number Total penalty for extra visits to multiorder points. |
total_payout |
Type: number Total amount of payouts to couriers. For vehicles, the entire payment for the route placed in metrics of first run. |
total_time_between_visits_penalty |
Type: number Total cost of violations of the |
unfeasible_couple_coupled_trailer_penalty |
Type: number Unfeasible penalty for coupling of coupled trailer. |
unfeasible_crossdock_missed_delivery_penalty |
Type: number Unfeasible penalty for missed delivery in crossdock. |
unfeasible_decouple_decoupled_trailer_penalty |
Type: number Unfeasible penalty for decoupling of decoupled trailer. |
unfeasible_decouple_unused_trailer_penalty |
Type: number Unfeasible penalty for decoupling of unused trailer. |
unfeasible_depots_only_at_run_beginning_penalty |
Type: number Unfeasible penalty for failed depots_only_at_run_beginning restriction. |
unfeasible_empty_first_run_penalty |
Type: number Unfeasible penalty for empty first shift run. |
unfeasible_failed_dependent_group_penalty |
Type: number Unfeasible penalty for failed dependent_group |
unfeasible_failed_expiring_time_penalty |
Type: number Unfeasible penalty for failed expiring_time |
unfeasible_failed_hard_time_window_penalty |
Type: number Unfeasible penalty for failed hard_time_window |
unfeasible_failed_lifo_order_penalty |
Type: number Unfeasible penalty for failed LIFO order. |
unfeasible_failed_ready_time_penalty |
Type: number Unfeasible penalty for failed ready_time. |
unfeasible_failed_sequence_order_penalty |
Type: number Unfeasible penalty for failed sequence_order |
unfeasible_failed_solid_group_penalty |
Type: number Unfeasible penalty for failed solid group. |
unfeasible_incompatible_load_types_penalty |
Type: number Unfeasible penalty for incompatible load types. |
unfeasible_incompatible_zones_penalty |
Type: number Unfeasible penalty for incompatible zones. |
unfeasible_invalid_pickup_delivery_order_penalty |
Type: number Unfeasible penalty for wrong order of serving pickup-delivery order. |
unfeasible_max_midde_depots_penalty |
Type: number Unfeasible penalty for failed max_middle_depots restriction. |
unfeasible_missed_coupled_delivery_penalty |
Type: number Unfeasible penalty for serving pickup without coupled delivery in route. |
unfeasible_missed_coupled_pickup_from_any_penalty |
Type: number Unfeasible penalty for missed pickup_from_any pickup. |
unfeasible_missed_coupled_pickup_penalty |
Type: number Unfeasible penalty for serving delivery without coupled pickup in route. |
unfeasible_missed_dependent_group_locations_penalty |
Type: number Unfeasible penalty for missed locations from dependent group. |
unfeasible_missed_planned_runs_penalty |
Type: number Unfeasible penalty for missed planned runs. |
unfeasible_not_loaded_order_penalty |
Type: number Unfeasible penalty for serving order which was not loaded at vehicle/ |
unfeasible_not_same_depot_route_ending_penalty |
Type: number Unfeasible penalty for failed finish_route_in_starting_depot restriction. |
unfeasible_not_same_depot_run_ending_penalty |
Type: number Unfeasible penalty for failed finish_run_in_starting_depot restriction. |
unfeasible_pickup_missed_depot_penalty |
Type: number Unfeasible penalty for pickup without relevant depot. |
unfeasible_pickup_missed_drop_off_penalty |
Type: number Unfeasible penalty for pickup without relevant drop_off. |
unfeasible_planned_overload_penalty |
Type: number Unfeasible penalty for vehicle planned overload. |
unfeasible_rolling_before_decoupling_penalty |
Type: number Unfeasible penalty for rolling trailer before decoupling it. |
unfeasible_rolling_without_trailer_penalty |
Type: number Unfeasible penalty for rolling without trailer. |
unfeasible_shift_overtime_penalty |
Type: number Unfeasible penalty for hard restricted shift overtime. |
unfeasible_trailer_diff_excess_penalty |
Type: number Unfeasible penalty for load diff between vehicle and trailer. |
unfeasible_transit_time_excess_penalty |
Type: number Unfeasible penalty for transit time violation. |
unfeasible_unused_middle_depot_penalty |
Type: number Unfeasible penalty for unused middle depot in route. |
unfeasible_use_trailer_prohibited_location_penalty |
Type: number Unfeasible penalty for trailer usage in location which not allow it. |
unfeasible_vehicle_overload_penalty |
Type: number Unfeasible penalty for vehicle overload. |
unfeasible_walking_after_route_end_penalty |
Type: number Unfeasible penalty for ending route with vehicle leftout on parking. |
unfeasible_walking_courier_overload_penalty |
Type: number Unfeasible penalty for walking courier overload. |
unfeasible_walking_to_depot_penalty |
Type: number Unfeasible penalty for visiting depot without vehicle. |
unfeasible_work_break_drop_penalty |
Type: number Unfeasible penalty for work break drop. |
solver_options_1
Solver options. It is forbidden to specify options that are not present in the list below.
Name |
Description |
time_zone* |
Type: number or string |
absolute_time |
Type: boolean Use ISO 8601 format (YYYY-MM-DDTHH:MM:SS+HH:MM) for |
avoid_tolls |
Type: boolean Do not use toll roads if possible (only for |
avoid_zones |
Type: string[] List of zones that cannot be entered when performing a route. These zones will be avoided even if the fastest route passes through them. The total number of corners in zone polygons must not exceed 300. Min length: Max length: Max items: |
balanced_groups |
Type: solver_options_1_balanced_groups_item[] Each item in this array defines a balanced group of routes. Each route in a group corresponds to a single vehicle shift. Shifts are linked with groups by |
close_location_groups_radius_m |
Type: number The distance specifying how close the locations must be to belong to the same close location group Max value: |
close_locations_during_post_optimization_only |
Type: boolean Apply penalties defined in |
critical_lateness_risk_probability |
Type: number If a probability of being late on a location is greater or equal than a specified value, than the location is accounted in Default: Min value: Max value: |
date |
Type: string Starting date for all routes ( Pattern: |
enable_vehicle_classes |
Type: boolean When true, solver will classify vehicles based on given vehicle specs to calculate more accurate distances between locations. Can be set to false to reduce size of the task and avoid "The task is too big" error. Default: |
fix_planned_shifts |
Type: boolean Fix shifts of locations from planned routes. |
force_merge_multiorders |
Type: boolean Меняет поведение при включенной опции |
global_proximity_factor |
Type: number Level of location proximity influence on vehicle routes. Recommended values are from Max value: |
ignore_min_stops_for_unused |
Type: boolean Ignore |
ignore_zones |
Type: boolean Ignore all zone-related options in vehicles and locations. More information |
immutable |
Type: boolean All routes, specified in initial_routes, are used without changes, new runs can not be added. |
incompatible_load_types |
Type: string[][] Each item in this array defines list of location load types, that should not be handled within the same vehicle run. More information |
incompatible_zones |
Type: string[][] Each item in this array defines list of location zones, that should not be visited within the same vehicle run. More information Min length: Max length: |
load_when_ready |
Type: boolean Start load orders in depot when they are ready (in order of |
location_groups |
Type: solver_options_1_location_groups_item[] Each item in this array defines a group of locations which should be assigned to the same vehicle shift. Some locations from the group might get dropped. Each location can be referenced by only one location group. More information |
matrix_router |
Type: string Matrix router to be used for route planning
Default: Enum: |
max_distance_to_projection_m |
Type: number Restriction for max distance to projcetion point. Will be ignored if order has not any suitable projection Default: Max value: |
max_drop_penalty_percentage |
Type: number Maximal relation of drop penalty to the sum of drop penalties in all orders. More information Default: Max value: |
max_split_orders_percentage |
Type: number Maximal ratio of orders which can be split into parts Default: Max value: |
merge_multiorders |
Type: boolean If possible merge those orders which have the same coordinates, i.e. serve them by a single vehicle. More information |
merge_multiorders_of_different_clients |
Type: boolean Если эта опция сброшена, то заказы с разным client_id но общей координатой будут образоывать отдельные остановки. Подробнее Default: |
minimize_lateness_risk |
Type: boolean Compute and minimize the probability of being late to locations. In other words, avoid routes such that the estimated time of arrival is close to the end of a time window. More information |
multiorder_radius_m |
Type: number The distance specifying how close the locations must be to be merged into a multiorder Default: Max value: |
penalize_late_service |
Type: boolean This option determines whether to penalize for late arrivals or late service.
|
penalty |
Type: solver_options_1_penalty Penalties for global solution limitations violation. |
points_throughputs |
Type: solver_options_1_points_throughputs_item[] Each item in this array defines point throughput. |
post_optimization |
Type: boolean Use post optimization: restart algorithm in the last 10% operations with disabled global proximity and balancing. More information |
proximity_factor |
Type: number Level of location proximity influence on vehicle routes. Recommended values are from Max value: |
quality |
Type: string Solution quality:
Default: Enum: |
restart_on_drop |
Type: boolean Restart to optimize only non-dropped orders, in case we haven't find solutions without drops. Enable this option if drops are expected and acceptable for your business scenario. |
routing_mode |
Type: string Transportation method. More information
Default: Enum: |
template_rest_schedules |
Type: solver_options_1_template_rest_schedules_item[] List of rest schedule templates. More information |
wait_in_multiorders |
Type: boolean Allows to wait in multiorders. More information Default: |
weighted_drop_penalty |
Type: boolean Compute drop penalty according to shipment weight and volume. It helps optimization when vehicles are highly loaded. Specified location drop penalties are ignored in this case. More information |
mvrp_response_routes_item
Name |
Description |
metrics* |
Type: route_metrics_1 Metrics for a single route. |
route* |
Type: route_element_1[] Sequence of route nodes, comprising a route. |
global_proximity_attraction_point |
Type: mvrp_response_routes_global_proximity_attraction_point Location of order to deliver from depot. |
run_number |
Type: integer Sequential number of a vehicle run. |
shift |
|
vehicle_id |
Type: integer or string Vehicle ID. All vehicle IDs in task must be unique and have the same type: integer or string. More information |
vehicle
Vehicle specification.
Name |
Description |
id* |
Type: integer or string Vehicle ID. All vehicle IDs in task must be unique and have the same type: integer or string. More information |
allow_different_depots_in_route |
Type: boolean Vehicle is allowed to visit depots with different ids in the same route |
allowed_zones |
Type: string[] List of zones, which can be visited by vehicle. More information Min length: Max length: |
can_change_depot_between_runs |
Type: boolean Vehicle is allowed to start the run from different depot than the one where its previous run has ended |
capacity |
Type: vehicle_capacity Vehicle capacity. More information |
close_locations |
Type: vehicle_close_locations_item[] |
cost |
Type: vehicle_cost_0 or string or vehicle_cost_1 |
crossdock_mode |
Type: string Defines whether this machine is allowed to deliver orders to the cross-dock depot. More information
Default: Enum: |
depot_extra_service_duration_s |
Type: number Additional time required to load this vehicle in the depot. Max value: |
depot_id |
Type: integer or string or array |
depots_only_at_run_beginning |
Type: boolean Middle depots are allowed only until first order location. |
ending_depot_id |
Type: integer or string or array |
excluded_tags |
Type: string[] List of excluding vehicle tags, checked for compatibility with location tags (POSIX-extended regular expression are used). More information |
finish_at |
Type: integer or string Defines |
finish_route_in_starting_depot |
Type: boolean Finish route in the same depot where it started. |
finish_run_in_starting_depot |
Type: boolean Finish runs in the same depot where it started. |
first_edges_penalty_factor |
Type: number A factor that determines extra penalty/bonus for the first edge of each run.If positive, solver tries to serve orders starting from the closest to depot. If negative, solver tries to serve orders starting from the most distant from depot |
fixed_planned_route |
Type: boolean If |
fixed_work_breaks |
Type: vehicle_fixed_work_breaks_item[] This list can be used for setting the duration of work before each break for several first breaks in each shift (or the whole route, if no shifts are present). If the list of shifts (see |
forbidden_zones |
Type: string[] List of zones, which can not be visited by vehicle. More information Min length: Max length: |
global_proximity_attraction_point |
Type: integer or string Defines |
imei |
Type: integer The number of the GPS tracker. |
immutable |
Type: boolean All routes for this vehicle, specified in initial_routes, are used without changes, new runs can not be added. |
incompatible_load_types |
Type: string[][] Each item in this array defines list of location load types, that should not be handled within the same vehicle run (overrides |
incompatible_zones |
Type: string[][] Each item in this array defines list of location zones, that should not be visited within the same vehicle run. (overrides Min length: Max length: |
last_edges_penalty_factor |
Type: number A factor that determines extra penalty/bonus for the last edge of each run.If positive, solver tries to end serving orders closer to depot. If negative, solver tries to end serving orders farther from depot |
max_middle_depots |
Type: integer Maximal number of middle depots (i.e. depots which do not break the run) in the route |
max_runs |
Type: integer Maximal number of the vehicle runs from the depot to locations in all shifts. More information Default: |
middle_depot_id |
Type: integer or string or array |
min_stop_weight |
Type: number Minimal total weight of all orders in one point. More information |
onboard_incompatible_load_types |
Type: boolean Determine load type incompatibility with respect only to orders on vehicle board. |
optional_zones |
Type: vehicle_optional_zones_item[] List of optional zones with bonus |
payout |
Type: string or vehicle_payout_0 |
penalty |
Type: vehicle_penalty Penalties for vehicle limitations violation. |
phone |
Type: string Phone number of the courier. |
planned_route |
Type: vehicle_planned_route A planned vehicle route, should be used to assign already chosen locations to vehicles. These locations will not be dropped even if some strict constraint(s) is violated and will be served by the vehicle. The order of locations provided in this option can be changed for optimization of final route. By default shifts assigned to planned locations can be changed as well. They can be fixed with |
preset_id |
Type: string Preset number for vehicle properties. |
ref |
Type: string Vehicle reference number. |
rest_schedule |
Type: vehicle_rest_schedule Schedule of rest breaks. More information |
rest_schedule_id |
Type: string ID of a rest schedule template used in this vehicle. |
return_to_depot |
Type: boolean If true, the vehicle returns to its Default: |
routing_mode |
Type: string Transportation method. If present, overrides
Enum: |
service_duration_multiplier |
Type: number Service duration adjustment coefficient for slow or fast workers. More information Default: Min value: |
shared_service_duration_multiplier |
Type: number Shared service duration adjustment coefficient for slow or fast workers. More information Default: Min value: |
shifts |
Type: vehicle_shifts_item[] List of vehicle shifts. More information |
specs |
Type: vehicle_specs Vehicle specification. More information |
start_at |
Type: integer or string Defines |
starting_depot_id |
Type: integer or string or array |
tags |
Type: string[] List of vehicle tags, checked for compatibility with location tags (POSIX-extended regular expression are used). More information |
trailer |
Type: vehicle_trailer Trailer specification. Usage of trailer with walking_courier is forbidden.More information |
travel_time_multiplier |
Type: number Travel duration adjustment coefficient for slow or fast vehicles. More information Default: Min value: |
visit_depot_at_start |
Type: boolean If true, the first route of the vehicle will go through the
Default: |
visited_locations |
Type: vehicle_visited_locations_item[] List of locations to be visited by a vehicle in exact order as fixed part of the route without optimizations, with optional times of departure from some locations. If the work breaks between visited locations need to be precisely scheduled, use |
walking_courier |
Type: vehicle_walking_courier Description of a pedestrian courier. Usage of walking_courier in vehicle with trailer is forbidden. |
detailed_cost_1
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: detailed_cost_1_raw_metrics_item[] The value of an arbitrary cost. |
subcosts |
Type: detailed_cost_1_subcosts_item[] The value of an arbitrary cost. |
mvrp_response_zones_item
Name |
Description |
geometry* |
|
id* |
Type: string Zone number |
coordinate_2
WGS84 coordinate of a location. More information
Name |
Description |
lat* |
Type: number Min value: Max value: |
lon* |
Type: number Min value: Max value: |
client_service_duration_0
Name |
Description |
fixed |
Type: number Fixed service duration for any part of the order. Max value: |
scaled |
Type: number Service time for a part of an order, which is multiplied by order ratio. Max value: |
crossdock_service_duration_0
Name |
Description |
fixed |
Type: number Fixed service duration for any part of the order. Max value: |
scaled |
Type: number Service time for a part of an order, which is multiplied by order ratio. Max value: |
depot_duration_0
Name |
Description |
fixed |
Type: number Fixed service duration for any part of the order. Max value: |
scaled |
Type: number Service time for a part of an order, which is multiplied by order ratio. Max value: |
mvrp_response_dropped_locations_optional_tags_item
An optional tag with bonus or penalty.
Name |
Description |
tag* |
Type: string An arbitrary tag. |
value* |
Type: number Value of the tag. When location is served by a vehicle with a matching tag in |
mvrp_response_dropped_locations_penalty
Penalties for non-completion and time window failure. More information
Name |
Description |
delivery_deadline |
Type: dropped_locations_penalty_delivery_deadline Penalty components for late deliveries from |
depot_expiring_time |
Type: dropped_locations_penalty_depot_expiring_time Penalty components for violation |
depot_ready_time |
Type: dropped_locations_penalty_depot_ready_time Penalty components for violation |
drop |
Type: penalty_drop_0_3 or number Penalty for not delivering an order. More information |
early |
Type: dropped_locations_penalty_early Penalty components for early service (used instead of |
late |
Type: dropped_locations_penalty_late Penalty components for late visits (used instead of |
out_of_time |
Type: dropped_locations_penalty_out_of_time Penalty components for time window failure. Can be used to set the values of |
rolling_throughput |
Type: dropped_locations_penalty_rolling_throughput Penalty components for throughput exceeding. |
throughput |
Type: dropped_locations_penalty_throughput Penalty components for throughput exceeding. |
time_between_visits |
Type: dropped_locations_penalty_time_between_visits Penalty components for exceeding |
transit_time |
Type: dropped_locations_penalty_transit_time Penalty components for exceeding transit time |
dropped_locations_quant_0_1
Minimal part which can be split from the order measured in one of the units
Name |
Description |
units |
Type: number Size of shipment in custom units. |
volume_cbm |
Type: number Volume of minimal part, cubic meters. |
weight_kg |
Type: number Weight of minimal part, kilograms. |
mvrp_response_dropped_locations_rolling_throughput
Rolling throughput limit (supported for anchors).
Name |
Description |
kg_per_hour |
Type: array or number |
units_per_hour |
Type: array or number |
vehicle_count |
Type: array or number |
service_duration_2_0
Name |
Description |
fixed |
Type: number Fixed service duration for any part of the order. Max value: |
scaled |
Type: number Service time for a part of an order, which is multiplied by order ratio. Max value: |
service_durations
Structure storing location service durations.
Name |
Description |
client |
Type: client_service_duration_0 or number Duration of service at a location, which can be shared among the other orders of the same client (by client_id) at exactly the same location. |
crossdock |
Type: crossdock_service_duration_0 or number Time spent at a crossdock location during the unloading of this order. More information |
depot |
Type: depot_duration_0 or number Time spent at a depot during handling of this location (goods loading, document collection, etc.). More information |
location |
Type: service_duration_2_0 or number Duration of service at location. Service duration can include any operations at location, such as loading or unloading items from a vehicle, or any other time associated with a location (apart from waiting, which is time after arrival and before service).More information |
parking |
Type: number Duration of parking at location. If the order is delivered using Max value: |
stop |
Type: shared_service_duration_0 or number Duration of service at a location, which can be shared among the other orders at exactly the same location. Shared service duration can include such operations as parking of a car, delivering documents, etc. More information |
shared_service_duration_0
Name |
Description |
fixed |
Type: number Fixed service duration for any part of the order. Max value: |
scaled |
Type: number Service time for a part of an order, which is multiplied by order ratio. Max value: |
mvrp_response_dropped_locations_shipment_size
Shipment size (dimensions and/or weight). More information
Name |
Description |
custom |
Type: number Size of shipment in custom units. Sizes in custom units are defined in format |
units |
Type: number Size of shipment in custom units. Max value: |
volume |
Type: dropped_locations_shipment_size_volume Shipment dimensions and type. |
volume_cbm |
Type: number Explicit volume, cubic meters. By default, the value is taken from "volume", if nothing is specified here. |
weight_kg |
Type: number Weight of shipment, kilograms. Max value: |
mvrp_response_dropped_locations_split_info
Information about split part of the order (in case if the order was split)
Name |
Description |
order_ratio |
Type: number Order ratio, included in this part. |
part_id |
Type: integer Number of this part of the order. |
parts_count |
Type: integer Number of parts, in which the order was split. |
units |
Type: number Size of this part in custom units (in case there was corresponding quant specified for this order). |
volume_cbm |
Type: number Volume of this part, cubic meters (in case there was corresponding quant specified for this order). |
weight_kg |
Type: number Weight of this part, kilograms (in case there was corresponding quant specified for this order). |
mvrp_response_dropped_locations_throughput
Location throughput limit (supported for the orders which can be split).
Name |
Description |
kg_per_hour |
Type: array or number |
units_per_hour |
Type: array or number |
vehicle_count |
Type: array or number |
mvrp_response_dropped_locations_time_windows_item
Name |
Description |
time_window* |
Type: string Allowed time window to visit location, in |
hard_time_window |
Type: string Allowed hard time window to visit location, in |
mvrp_response_dropped_locations_transit_time
Restrictions on the time the order spends inside a vehicle
Name |
Description |
hard_limit_s |
Type: number Hard time limit, values above it are unacceptable Max value: |
limit_s |
Type: number Soft time limit, values above it are acceptable but they will be penalized Max value: |
solver_options_1_balanced_groups_item
A group of balanced routes. If the penalty
field is not set, the penalty {stop
: 100, hour
: 200} is used for backward compatibility.
Name |
Description |
id* |
Type: string A unique ID of a balanced group of routes. |
penalty |
Type: solver_options_1_balanced_groups_penalty Penalties for imbalanced routes. |
solver_options_1_location_groups_item
A group of locations which should be assigned to the same vehicle shift.
Name |
Description |
location_ids* |
Type: (integer or string)[] Reference to a location specified in |
dependent |
Type: boolean When true, either all or none of the locations in group will be served. |
solid |
Type: boolean When true, all assigned locations in group will be served consecutively, but their order is not fixed. |
title |
Type: string |
solver_options_1_penalty
Penalties for global solution limitations violation.
Name |
Description |
close_location_groups |
Type: solver_options_1_penalty_close_location_groups Penalty components for extra visits to close location group poins. |
drop_penalty_percentage |
Type: solver_options_1_penalty_drop_penalty_percentage Penalty components for |
multiorders |
Type: solver_options_1_penalty_multiorders Penalty components for extra visits to multiorder poins. |
split_orders_percentage |
Type: solver_options_1_penalty_split_orders_percentage Penalty components for |
solver_options_1_points_throughputs_item
Point's throughput
Name |
Description |
penalty |
|
point |
Type: solver_options_1_points_throughputs_point WGS84 coordinate of a location. More information |
throughput |
Type: solver_options_1_points_throughputs_throughput Point throughput limit. |
solver_options_1_template_rest_schedules_item
Template schedule of rest breaks.
Name |
Description |
breaks* |
Type: array |
id* |
Type: string A unique ID of a template. |
route_metrics_1
Metrics for a single route.
Name |
Description |
arrival_after_start_penalty* |
Type: number Penalty for arrived after start of timewindow |
depot_throughput_violation_kg* |
Type: number Total violation of depot throughput, kilograms. |
depot_throughput_violation_kg_per_hour* |
Type: number Total violation of depot throughput, kilograms per hour (deprecated). |
depot_throughput_violation_units* |
Type: number Total violation of depot throughput, units. |
depot_throughput_violation_units_per_hour* |
Type: number Total violation of depot throughput, units per hour (deprecated). |
depot_throughput_violation_vehicles* |
Type: number Total violation of depot throughput, vehicles. |
early_depot_count* |
Type: integer Number of arrivals to a depot earlier than the specified time window. |
early_locations_count* |
Type: integer Number of locations where arrival will happen earlier than the picked time window. |
early_shifts_count* |
Type: integer Number of shifts where arrival will happen earlier than the specified time window. |
empty_runs_penalty* |
Type: number Penalty for empty runs, which cannot be skipped because of actual visit times. |
failed_dropped_breaks_count* |
Type: integer Number of work breaks that are not used in the route, although they should be. |
failed_dropped_breaks_duration_s* |
Type: number Total duration of failures for work breaks that are not used in the route, although they should be, seconds. |
failed_dropped_breaks_penalty* |
Type: number Sum of penalties for work breaks that are not used in the route, although they should be. |
failed_max_work_duration_count* |
Type: integer Number of continuous work time intervals which violate specified maximal work duration. |
failed_min_work_duration_count* |
Type: integer Number of continuous work time intervals which violate specified minimal work duration. |
failed_time_window_depot_count* |
Type: integer Number of arrivals to a depot outside of the time window. |
failed_time_window_depot_count_penalty* |
Type: number Sum of fixed penalties applied for violations of depot time windows. |
failed_time_window_depot_duration_penalty* |
Type: number Sum of per minute penalties applied for violations of depot time windows. |
failed_time_window_depot_duration_s* |
Type: number Total duration of depot time window fails, seconds. |
failed_time_window_depots_total_penalty* |
Type: number Total cost for depot time window fails. |
failed_time_window_locations_count* |
Type: integer Number of locations where arrival will happen outside of the time window. |
failed_time_window_locations_count_penalty* |
Type: number Sum of fixed penalties applied for arriving at order location out of the time window. |
failed_time_window_locations_duration_penalty* |
Type: number Sum of per minute penalties applied for arriving at location out of the time window. |
failed_time_window_locations_duration_s* |
Type: number Total duration of location time window fails, seconds. |
failed_time_window_locations_total_penalty* |
Type: number Total cost for location time window fails. |
failed_time_window_shifts_count* |
Type: integer Number of shifts where arrival will happen outside of the time window. |
failed_time_window_shifts_count_penalty* |
Type: number Sum of fixed penalties applied for violations of shift time windows. |
failed_time_window_shifts_duration_penalty* |
Type: number Sum of per minute penalties applied for violations of shift time windows. |
failed_time_window_shifts_duration_s* |
Type: number Total duration of shift time window fails, seconds. |
failed_time_window_shifts_total_penalty* |
Type: number Total cost for shift time window fails. |
failed_work_duration_count* |
Type: integer Number of continuous work time intervals which violate specified minimal or maximal work duration. |
failed_work_duration_count_penalty* |
Type: number Sum of fixed penalties applied for failures of continuous work duration minimal or maximal limits. |
failed_work_duration_penalty* |
Type: number Sum of per minute penalties applied for failures of continuous work duration. |
failed_work_duration_s* |
Type: number Total duration of continuous work time interval failures, seconds. |
failed_work_duration_total_penalty* |
Type: number Total cost for continuous work time interval failures. |
first_edges_penalty* |
Type: number The total penalty for the first edge of every run |
global_proximity* |
Type: number Global proximity level of route(s): average possible distance from the last location in route, kilometers. |
last_edges_penalty* |
Type: number The total penalty for the last edge of every run |
late_depot_count* |
Type: integer Number of arrivals to a depot later than the specified time window. |
late_locations_count* |
Type: integer Number of locations where arrival will happen later than the picked time window. |
late_shifts_count* |
Type: integer Number of shifts where arrival will happen later than the specified time window. |
lateness_risk_locations_count* |
Type: integer Number of locations and deadlines with a risk of late arrival. |
max_distance_from_depot_m* |
Type: number Maximal distance from order location to the depot. |
max_distance_to_attraction_point_m* |
Type: number Maximal distance from order location to the global_proximity_attraction_point. |
max_distance_to_garage_m* |
Type: number Maximal distance from order location to the depot. |
objective_minimum* |
Type: number Minimum of optimization objective. |
overtime_duration_penalty* |
Type: number Sum of per minute penalties applied for violating of maximal shift duration. |
overtime_duration_s* |
Type: number Total shift overtime duration in seconds. |
overtime_penalty* |
Type: number Sum of penalties applied for violating of maximal shift duration. |
overtime_shifts_count* |
Type: integer Number of shifts where duration is more than |
overtime_shifts_count_penalty* |
Type: number Sum of fixed penalties applied for violating of maximal shift duration. |
proximity* |
Type: number Proximity level of route(s): average possible distance between two locations en route, kilometers. |
total_cost* |
Type: number Total of all expenses. |
total_cost_with_penalty* |
Type: number Total expectation of all expenses including guaranteed and probable penalties. |
total_drop_penalty* |
Type: number Sum of dropped locations penalties per drop. |
total_duration_cost* |
Type: number Total of all used vehicles costs per duration of usage. |
total_duration_s* |
Type: number Total duration including transit, service and waiting time, seconds. |
total_early_count* |
Type: integer Total number of arrivals earlier than the picked time window. |
total_early_duration_s* |
Type: number Total duration of early arrivals, sum of (start of the time window) - (arrival time), seconds. |
total_early_penalty* |
Type: number Sum of penalties applied for arriving and serving at location earlier than the picked time window. |
total_empty_distance_m* |
Type: number Total distance traveled without any orders in vehicle. |
total_failed_delivery_deadline_count* |
Type: number Total number of failed deadlines. |
total_failed_delivery_deadline_duration_s* |
Type: number Total duration of deadlines fails, seconds. |
total_failed_delivery_deadline_penalty* |
Type: number Sum of penalties applied for arriving and serving at depot after the deadline. |
total_failed_time_window_count* |
Type: integer Total number of time window fails (sum of |
total_failed_time_window_duration_s* |
Type: number Total duration of time window fails (sum of |
total_failed_time_window_penalty* |
Type: number Sum of penalties applied for being out of the time window at location, shift or depot. |
total_fails_penalty* |
Type: number Sum of fails penalties |
total_fixed_cost* |
Type: number Total of all used vehicles fixed costs. |
total_global_proximity_distance_m* |
Type: number Total global proximity distance, meters. |
total_global_proximity_duration_s* |
Type: number Total global proximity duration, seconds. |
total_global_proximity_penalty* |
Type: number Sum of global proximity penalties. |
total_guaranteed_penalty* |
Type: number Total of all guaranteed penalties. |
total_late_count* |
Type: integer Total number of arrivals later than the picked time window. |
total_late_duration_s* |
Type: number Total duration of late arrivals, sum of (arrival time) - (end of the time window), seconds. |
total_late_penalty* |
Type: number Sum of penalties applied for arriving and serving at location later than the picked time window. |
total_lateness_risk_probability* |
Type: number Sum of all probabilities of being late on locations and deadlines. |
total_locations_cost* |
Type: number Total of all used vehicles costs per location. |
total_middle_depots* |
Type: integer Number of middle depots. |
total_mileage_penalty* |
Type: number Total penalties applied for mileage limit violation. |
total_min_stop_weight_penalty* |
Type: number Total penalties applied for min_stop_weight violation. |
total_non_empty_distance_m* |
Type: number Total distance traveled with at least one order in vehicle. |
total_optional_tags_cost* |
Type: number The value added to the total cost by optional tags. |
total_optional_zones_cost* |
Type: number The value added to the total cost by optional zones. |
total_penalty* |
Type: number Sum of guaranteed and probable penalties. |
total_probable_penalty* |
Type: number Expected total of all probable penalties. |
total_proximity_distance_m* |
Type: number Total proximity distance, meters. |
total_proximity_duration_s* |
Type: number Total proximity duration, seconds. |
total_proximity_penalty* |
Type: number Sum of proximity penalties. |
total_rest_duration_s* |
Type: number Total duration of work breaks, seconds |
total_runs_cost* |
Type: number Total of all used vehicles costs per run. |
total_served_orders* |
Type: number The total number of orders served. |
total_service_duration_s* |
Type: number Total duration of service at locations, seconds |
total_soft_depot_expiring_time_penalty* |
Type: number Total penalty for violating the soft_depot_expiring_time |
total_soft_depot_ready_time_penalty* |
Type: number Total penalty for violating the soft_depot_ready_time |
total_stop_count_penalty* |
Type: number Total penalties applied for stop count limit violation. |
total_stops* |
Type: integer Number of vehicle stops - different sequential order locations en route. |
total_trailer_rolling_cost* |
Type: number Total penalty for rolling goods from the trailer to the head. |
total_trailer_rolling_count* |
Type: number Total number of rollings of goods from the trailer to the head. |
total_trailer_transit_distance_m* |
Type: number Total transit distance with the coupled trailer, meters. |
total_trailer_transit_duration_s* |
Type: number Total transit with the coupled trailer duration (driving duration), seconds. |
total_transit_distance_cost* |
Type: number Total of all used vehicles costs per transit distance. |
total_transit_distance_m* |
Type: number Total transit distance, meters. If |
total_transit_duration_s* |
Type: number Total transit duration (driving duration), seconds. |
total_transport_work_cost* |
Type: number Total transport work cost (transport cost for each vehicle is taken with specified weight). |
total_transport_work_tonne_km* |
Type: number Total transport work (product of cargo weight and route length), tonne-km. |
total_unfeasibility_count* |
Type: number Number of locations which violate strict constraints but cannot be dropped. |
total_unfeasibility_penalty* |
Type: number Sum of location drop penalties applied for locations which violate strict constraints but cannot be dropped. |
total_unique_stops* |
Type: integer Number of vehicle stops with unique coordinates excluding depots and garages |
total_units* |
Type: number Total weight of orders in the route in units. |
total_volume_m3* |
Type: number Total volume of orders in the route, cubic meters. |
total_waiting_duration_s* |
Type: number Total duration of waiting at locations before travel to other locations or the start of the time window, seconds. |
total_walking_distance_m* |
Type: number Total walking distance of the |
total_walking_duration_s* |
Type: number Total walking duration of the |
total_walking_edge_distance_excess* |
Type: number Total excess of the allowed maximum length of walking edges. |
total_walking_edge_penalty* |
Type: number Total penalty for exceeding the maximum length of walking edges. |
total_weight_kg* |
Type: number Total weight of orders in the route, kilograms. |
total_work_breaks* |
Type: integer Total number of work breaks. |
transit_time_penalty* |
Type: number Penalty for transit time violation. |
utilization_units* |
Type: number Vehicle utilization, units. |
utilization_units_perc* |
Type: number Vehicle units utilization, percent. |
utilization_volume_m3* |
Type: number Vehicle volume utilization, cubic meters. |
utilization_volume_perc* |
Type: number Vehicle volume utilization, percent. |
utilization_weight_kg* |
Type: number Vehicle weight utilization, kilograms. |
utilization_weight_perc* |
Type: number Vehicle weight utilization, percent. |
dropped_orders_units |
Type: number Total weight of orders in the route in units. |
dropped_orders_volume_m3 |
Type: number Total volume of orders in the route, cubic meters. |
dropped_orders_weight_kg |
Type: number Total weight of orders in the route, kilograms. |
new_global_proximity |
Type: number New value of global_proximity metric after post optimization. |
new_objective_minimum |
Type: number New value of objective_minimum metric after post optimization. |
new_total_cost_with_penalty |
Type: number New value of total_cost_with_penalty metric after post optimization. |
new_total_global_proximity_distance_m |
Type: number New value of total_global_proximity_distance_m metric after post optimization. |
new_total_global_proximity_duration_s |
Type: number New value of total_global_proximity_duration_s metric after post optimization. |
new_total_global_proximity_penalty |
Type: number New value of total_global_proximity_penalty metric after post optimization. |
new_total_guaranteed_penalty |
Type: number New value of total_guaranteed_penalty metric after post optimization. |
new_total_penalty |
Type: number New value of total_penalty metric after post optimization. |
new_total_stop_count_penalty |
Type: number New value of total_stop_count_penalty metric after post optimization. |
new_total_stops |
Type: integer New value of total_stops metric after post optimization. |
old_global_proximity |
Type: number Old value of global_proximity metric after post optimization. |
old_objective_minimum |
Type: number Old value of objective_minimum metric after post optimization. |
old_total_cost_with_penalty |
Type: number Old value of total_cost_with_penalty metric after post optimization. |
old_total_global_proximity_distance_m |
Type: number Old value of total_global_proximity_distance_m metric after post optimization. |
old_total_global_proximity_duration_s |
Type: number Old value of total_global_proximity_duration_s metric after post optimization. |
old_total_global_proximity_penalty |
Type: number Old value of total_global_proximity_penalty metric after post optimization. |
old_total_guaranteed_penalty |
Type: number Old value of total_guaranteed_penalty metric after post optimization. |
old_total_penalty |
Type: number Old value of total_penalty metric after post optimization. |
old_total_stop_count_penalty |
Type: number Old value of total_stop_count_penalty metric after post optimization. |
old_total_stops |
Type: integer Old value of total_stops metric after post optimization. |
route_custom_cost |
Type: number Cost of custom defined expenses for route. For vehicles, the entire cost placed in metrics of route first run. |
route_payout |
Type: number Payout to courier of custom defined expenses for route. For vehicles, the entire payout placed in metrics of route first run. |
run_custom_cost |
Type: number Cost of custom defined expenses for run. |
run_payout |
Type: number Payout to courier of custom defined expenses for run. |
shift_custom_cost |
Type: number Cost of custom defined expenses for shift. For vehicles, the entire cost placed in metrics of shift first run. |
shift_payout |
Type: number Payout to courier of custom defined expenses for shift. For vehicles, the entire payout placed in metrics of shift first run. |
shift_total_custom_cost |
Type: number Total cost of custom defined expenses for shift. Includes cost of the shift and the cost of runs included in the shift. For vehicles, the entire cost placed in metrics of shift first run. |
shift_total_payout |
Type: number Total payout to courier of custom defined expenses for shift. Includes payout of the shift and the payout of runs included in the shift. For vehicles, the entire payout placed in metrics of shift first run. |
total_custom_cost |
Type: number Total cost of all custom defined expenses. Includes expenses for the route, shifts and runs. For vehicles, the entire route cost placed in metrics of first run. |
total_depot_penalty |
Type: number Sum of depot penalties. |
total_multiorders_penalty |
Type: number Total penalty for extra visits to multiorder points. |
total_payout |
Type: number Total amount of payouts to couriers. For vehicles, the entire payment for the route placed in metrics of first run. |
unfeasible_couple_coupled_trailer_penalty |
Type: number Unfeasible penalty for coupling of coupled trailer. |
unfeasible_crossdock_missed_delivery_penalty |
Type: number Unfeasible penalty for missed delivery in crossdock. |
unfeasible_decouple_decoupled_trailer_penalty |
Type: number Unfeasible penalty for decoupling of decoupled trailer. |
unfeasible_decouple_unused_trailer_penalty |
Type: number Unfeasible penalty for decoupling of unused trailer. |
unfeasible_depots_only_at_run_beginning_penalty |
Type: number Unfeasible penalty for failed depots_only_at_run_beginning restriction. |
unfeasible_empty_first_run_penalty |
Type: number Unfeasible penalty for empty first shift run. |
unfeasible_failed_dependent_group_penalty |
Type: number Unfeasible penalty for failed dependent_group |
unfeasible_failed_expiring_time_penalty |
Type: number Unfeasible penalty for failed expiring_time |
unfeasible_failed_hard_time_window_penalty |
Type: number Unfeasible penalty for failed hard_time_window |
unfeasible_failed_lifo_order_penalty |
Type: number Unfeasible penalty for failed LIFO order. |
unfeasible_failed_ready_time_penalty |
Type: number Unfeasible penalty for failed ready_time. |
unfeasible_failed_sequence_order_penalty |
Type: number Unfeasible penalty for failed sequence_order |
unfeasible_failed_solid_group_penalty |
Type: number Unfeasible penalty for failed solid group. |
unfeasible_incompatible_load_types_penalty |
Type: number Unfeasible penalty for incompatible load types. |
unfeasible_incompatible_zones_penalty |
Type: number Unfeasible penalty for incompatible zones. |
unfeasible_invalid_pickup_delivery_order_penalty |
Type: number Unfeasible penalty for wrong order of serving pickup-delivery order. |
unfeasible_max_midde_depots_penalty |
Type: number Unfeasible penalty for failed max_middle_depots restriction. |
unfeasible_missed_coupled_delivery_penalty |
Type: number Unfeasible penalty for serving pickup without coupled delivery in route. |
unfeasible_missed_coupled_pickup_from_any_penalty |
Type: number Unfeasible penalty for missed pickup_from_any pickup. |
unfeasible_missed_coupled_pickup_penalty |
Type: number Unfeasible penalty for serving delivery without coupled pickup in route. |
unfeasible_missed_dependent_group_locations_penalty |
Type: number Unfeasible penalty for missed locations from dependent group. |
unfeasible_missed_planned_runs_penalty |
Type: number Unfeasible penalty for missed planned runs. |
unfeasible_not_loaded_order_penalty |
Type: number Unfeasible penalty for serving order which was not loaded at vehicle/ |
unfeasible_not_same_depot_route_ending_penalty |
Type: number Unfeasible penalty for failed finish_route_in_starting_depot restriction. |
unfeasible_not_same_depot_run_ending_penalty |
Type: number Unfeasible penalty for failed finish_run_in_starting_depot restriction. |
unfeasible_pickup_missed_depot_penalty |
Type: number Unfeasible penalty for pickup without relevant depot. |
unfeasible_pickup_missed_drop_off_penalty |
Type: number Unfeasible penalty for pickup without relevant drop_off. |
unfeasible_planned_overload_penalty |
Type: number Unfeasible penalty for vehicle planned overload. |
unfeasible_rolling_before_decoupling_penalty |
Type: number Unfeasible penalty for rolling trailer before decoupling it. |
unfeasible_rolling_without_trailer_penalty |
Type: number Unfeasible penalty for rolling without trailer. |
unfeasible_shift_overtime_penalty |
Type: number Unfeasible penalty for hard restricted shift overtime. |
unfeasible_trailer_diff_excess_penalty |
Type: number Unfeasible penalty for load diff between vehicle and trailer. |
unfeasible_transit_time_excess_penalty |
Type: number Unfeasible penalty for transit time violation. |
unfeasible_unused_middle_depot_penalty |
Type: number Unfeasible penalty for unused middle depot in route. |
unfeasible_use_trailer_prohibited_location_penalty |
Type: number Unfeasible penalty for trailer usage in location which not allow it. |
unfeasible_vehicle_overload_penalty |
Type: number Unfeasible penalty for vehicle overload. |
unfeasible_walking_after_route_end_penalty |
Type: number Unfeasible penalty for ending route with vehicle leftout on parking. |
unfeasible_walking_courier_overload_penalty |
Type: number Unfeasible penalty for walking courier overload. |
unfeasible_walking_to_depot_penalty |
Type: number Unfeasible penalty for visiting depot without vehicle. |
unfeasible_work_break_drop_penalty |
Type: number Unfeasible penalty for work break drop. |
route_element_1
Route node, contains information about a visited location or a work break, transit information and arrival time.
Name |
Description |
arrival_time_s* |
Type: number Arrival time at the location. Arrival happened before the start of the time window, will incur waiting time. |
node* |
Type: route_node_depot or route_node_location_1 or route_node_work_break or route_node_courier_position Route component. |
transit_distance_m* |
Type: number Transit distance to a location, meters. If routing_mode is set to "transit", only pedestrian distance part of the route is considered. |
transit_duration_s* |
Type: number Transit time to a location, seconds. |
actual_arrival_time_s |
Type: number Actual arrival time at the location. |
actual_departure_time_s |
Type: number Actual time of departure from the location. |
actual_service_start_time_s |
Type: number Actual time of service start in the location. |
actual_waiting_duration_s |
Type: number Waiting duration, time spent at location after arrival and before the start of the time window, seconds. |
departure_time_s |
Type: number Time of departure from the location. |
failed_time_window |
|
load_to_head |
Type: (integer or string)[] List of orders that should be loaded to the head of the vehicle at depot or anchor location, in case trailers are used. Orders are listed in the order of serving. |
load_to_trailer |
Type: (integer or string)[] List of orders that should be loaded to the trailer of the vehicle at depot, in case trailers are used. Orders are listed in the order of serving. |
multi_order |
Type: boolean An order is one of several orders at exactly the same location which are served together. Arrival time is the same for all orders in the group, also the orders share |
overtime |
Type: route_element_1_overtime |
probably_failed_time_window |
|
stop_sequence_number |
Type: integer Sequence number of a stop (among delivery, pickup and drop_off locations) |
violations |
Type: (route_element_1_violations_0 or route_element_1_violations_1)[] List of violations. |
waiting_duration_s |
Type: number Waiting duration, time spent at location after arrival and before the start of the time window, seconds. |
mvrp_response_routes_global_proximity_attraction_point
Location of order to deliver from depot.
Name |
Description |
id* |
Type: integer or string Location ID. All locations IDs in task must be unique and have the same type: integer or string. More information |
point* |
Type: coordinate_2 WGS84 coordinate of a location. More information |
address |
Type: string Address of the location. |
allow_trailers |
Type: boolean When |
can_be_merged |
Type: boolean An order can be a part of multiorder Default: |
can_be_split |
Type: boolean An order can be split into parts between different vehicles. |
client_id |
Type: integer or string Defines |
client_service_duration_s |
Type: client_service_duration_0 or number Duration of service at a location, which can be shared among the other orders of the same client (by client_id) at exactly the same location. |
comments |
Type: string Comments. |
crossdock_mode |
Type: string Defines whether it is allowed to deliver this order through a cross-dock depot.
Default: Enum: |
crossdock_service_duration_s |
Type: crossdock_service_duration_0 or number Time spent at a crossdock location during the unloading of this order. More information |
custom_value |
Type: number A custom numeric value, associated with location (E.g. the reward for the courier for visiting this location). May be used as a component in vehicle cost function. |
delivery_deadline |
Type: string Time by which the |
delivery_to |
Type: integer or string Defines |
delivery_to_any |
Type: (integer or string)[] A list of |
depot_duration_s |
Type: depot_duration_0 or number Time spent at a depot during handling of this location (goods loading, document collection, etc.). More information |
depot_expiring_time |
Type: string Time by which the order must be taken from the depot, in |
depot_id |
Type: integer or string or array |
depot_ready_time |
Type: string Time when the order is ready to be taken from any depot, in |
description |
Type: string Location description. |
dropped_ratio |
Type: number Order ratio which have to stay in drop Max value: |
hard_time_window |
Type: string Allowed hard time window to visit location, in |
hard_window |
Type: boolean Restricts time window relaxation during route planning. If location cannot be visited within a specified time window, it will be excluded from the route and added to |
ignore_zones_compatibility |
Type: boolean Ignore the effects caused by the |
in_lifo_order |
Type: boolean Orders with this field set to |
load_types |
Type: string[] Defines types of location load.
mustn |
max_split_parts |
Type: integer Maximal number of parts in which the order can be split Default: Min value: |
max_total_vehicles |
Type: integer Maximal number of vehicles that can be served by an anchor location. Unlimited by default. More information |
may_drop_in_crossdock |
Type: boolean May drop pickup order in crossdock location Default: |
optional_tags |
Type: routes_global_proximity_attraction_point_optional_tags_item[] List of tags which are not required for a vehicle to serve the location, but they can decrease or increase the route cost if satisfied. More information |
parking_service_duration_s |
Type: number Duration of parking at location. If the order is delivered using Max value: |
penalty |
Type: routes_global_proximity_attraction_point_penalty_1 Penalties for non-completion and time window failure. More information |
phone |
Type: string Phone number of delivery receiver. |
pickup_from_any |
Type: boolean Delivery-orders that have this field set to |
pickup_must_reach_depot |
Type: boolean The field determines whether the pickup is considered serviced if it is not delivered depot. The field shouldnt be defined for types other than pickup. The field is mutually exclusive with fields |
preset_id |
Type: string Preset number for location properties. |
quant |
Type: number or global_proximity_attraction_point_quant_0_1 |
ref |
Type: string Location reference. |
required_tags |
Type: string[] List of tags a vehicle must have to arrive at the location. More information |
rolling_throughput |
Type: routes_global_proximity_attraction_point_rolling_throughput Rolling throughput limit (supported for anchors). |
sequence_order |
Type: integer All locations in vehicle route with specified sequence_order option have to be visited in non-decreasing order of its values. More information |
service_duration_s |
Type: service_duration_2_0 or number Duration of service at location. Service duration can include any operations at location, such as loading or unloading items from a vehicle, or any other time associated with a location (apart from waiting, which is time after arrival and before service).More information |
service_durations |
Type: service_durations Structure storing location service durations. |
shared_service_duration_s |
Type: shared_service_duration_0 or number Duration of service at a location, which can be shared among the other orders at exactly the same location. Shared service duration can include such operations as parking of a car, delivering documents, etc. More information |
shared_with_company_ids |
Type: integer[] IDs of the companies that can access the order information. |
shipment_size |
Type: routes_global_proximity_attraction_point_shipment_size Shipment size (dimensions and/or weight). More information |
soft_depot_expiring_time |
Type: string Time by which the order must be taken from the depot, in |
soft_depot_ready_time |
Type: string Time when the order is ready to be taken from any depot, in |
split_parts_must_fill_whole_vehicle |
Type: boolean Parts, split from a splittable order, should fill the whole vehicle. |
throughput |
Type: routes_global_proximity_attraction_point_throughput Location throughput limit (supported for the orders which can be split). |
time_window |
Type: string Allowed time window to visit location, in |
time_windows |
Type: routes_global_proximity_attraction_point_time_windows_item[] List of allowed time windows. Time windows can not overlap. Fields |
title |
Type: string Location title. |
transit_time |
Type: routes_global_proximity_attraction_point_transit_time Restrictions on the time the order spends inside a vehicle |
type |
Type: string Defines a type of service at the location:
Default: Enum: |
use_in_proximity |
Type: boolean When Default: |
mvrp_response_routes_shift
Name |
Description |
id* |
Type: string Unique identifier of a shift. |
balanced_group_id |
Type: string ID of a corresponding balanced group of routes (see the option |
end |
Type: routes_shift_end_1 Route node, contains information about a visited location or a work break, transit information and arrival time. |
start |
Type: routes_shift_start_1 Route node, contains information about a visited location or a work break, transit information and arrival time. |
vehicle_capacity
Vehicle capacity. More information
Name |
Description |
custom |
Type: number Amount of custom units a vehicle is able to carry. Capacities in custom units are defined in format |
limits |
Type: vehicle_capacity_limits Vehicle load limits. |
units |
Type: number Amount of custom units a vehicle is able to carry. Default: |
volume |
Type: vehicle_capacity_volume Vehicle dimensions. |
volume_cbm |
Type: number Volume a vehicle is able to fit, cubic meters. |
weight_kg |
Type: number Weight a vehicle is able to carry, kilograms. Default: |
vehicle_close_locations_item
Name |
Description |
distance_till_service_m |
|
duration_till_service_s |
|
routing_mode |
Type: string Transportation method is used to determine close locations. This parameter can be used only if the Enum: |
search_radius_m |
Type: number Maximum distance between two locations in meters at which locations on which the restriction is applied. Max value: |
soft_search_radius_m |
Type: number If value is greater than the corresponding value of the Max value: |
vehicle_cost_0
Vehicle cost. More information
Name |
Description |
fixed |
Type: number Cost per fact of vehicle use (cost occurred if vehicle is included in route). Default: |
hour |
Type: number Cost of using vehicle per hour. It should not be zero or very small, otherwise you may get routes which are not optimal in terms of time. Default: |
km |
Type: number Cost of using vehicle per kilometer. It should not be zero or very small, otherwise you may get routes which are not optimal in terms of distance. Default: |
location |
Type: number Cost of using vehicle per location (default 0). |
run |
Type: number Cost per single vehicle run from depot to locations. |
tonne_km |
Type: number Cost of carrying one tonne for one kilometer (default 0). |
waiting_hour |
Type: number Cost of waiting per hour. If not defined, the value specified in the |
vehicle_cost_1
Description of the cost of using the vehicle with the possibility of specifying arithmetic expressions for individual parts of the route. The total cost will be obtained as the sum of all the specified expressions for all parts included in the route.
Name |
Description |
route |
Type: string Arithmetic expression representing route cost |
run |
Type: string Arithmetic expression representing run cost |
shift |
Type: string Arithmetic expression representing shift cost |
vehicle_fixed_work_breaks_item
Name |
Description |
work_duration_s* |
Type: number Duration of continuous work before the break, seconds. Max value: |
shift_id |
Type: string Unique identifier of a shift. |
vehicle_optional_zones_item
An optional tag with bonus.
Name |
Description |
value* |
Type: number Value of the zone. This value is subtracted from the route cost for any served location with a matching zone.For location with multiple matching zones will be chosen the maximum bonus. |
zone* |
Type: string Zone number. Min length: Max length: |
vehicle_payout_0
Description of the payout to the courier for completing the route with the possibility of specifying arithmetic expressions for individual parts of the route. The total payout will be obtained as the sum of all the specified expressions for all parts included in the route.
Name |
Description |
route |
Type: string Arithmetic expression representing route cost |
run |
Type: string Arithmetic expression representing run cost |
shift |
Type: string Arithmetic expression representing shift cost |
vehicle_penalty
Penalties for vehicle limitations violation.
Name |
Description |
arrival_after_start |
Type: vehicle_penalty_arrival_after_start Penalty components for arrived after start of timewindow |
empty_runs |
Type: vehicle_penalty_empty_runs Penalty components for empty runs, which cannot be skipped because of actual visit times. |
min_stop_weight |
Type: vehicle_penalty_min_stop_weight Penalty components for insufficient total orders weight in point. |
vehicle_planned_route
A planned vehicle route, should be used to assign already chosen locations to vehicles. These locations will not be dropped even if some strict constraint(s) is violated and will be served by the vehicle. The order of locations provided in this option can be changed for optimization of final route. By default shifts assigned to planned locations can be changed as well. They can be fixed with fix_planned_shifts
solver option. More information
Name |
Description |
locations* |
Type: vehicle_planned_route_locations_item[] A planned order of locations in a vehicle route including all shifts and multiple runs. If the list of shifts (see |
planned_runs_first |
Type: boolean It is necessary to visit all depots, listed in |
start_time |
Type: string or array |
work_breaks |
Type: vehicle_planned_route_work_breaks_item[] Planned work breaks for a vehicle route including all shifts and multiple runs. If the list of shifts (see |
vehicle_shifts_item
Vehicle shift.
Name |
Description |
id* |
Type: string Unique identifier of a shift. |
time_window* |
Type: string Allowed time window to visit location, in |
balanced_group_id |
Type: string ID of a corresponding balanced group of routes (see the option |
hard_max_duration_s |
Type: number Hard limit on the maximum shift duration in seconds. If both Default: Max value: |
hard_time_window |
Type: string Allowed hard time window to visit location, in |
hard_window |
Type: boolean Restricts time window relaxation during route planning. When true, vehicles are allowed to finish a shift only within the specified time window. More information |
immutable |
Type: boolean All routes for this shift, specified in initial_routes, are used without changes, new runs can not be added. |
max_duration_s |
Type: number Maximal duration of a shift in seconds. If a planned shift duration is greater than specified, the shift out of time penalties are applied. Default: Max value: |
max_mileage_km |
Type: number Maximal mileage of the vehicle during the shift in kilometers. If a planned mileage is greater than this value, the penalties from a shift parameter |
max_runs |
Type: integer Maximal number of the vehicle runs from the depot to locations in shift. Default: |
maximal_stops |
Type: integer Maximal number of shift stops, if the final stop count is greater than this value, |
minimal_stops |
Type: integer Minimal number of shift stops, if the final stop count is less than this value, |
minimal_unique_stops |
Type: integer Minimal number of shift stops with unique coordinates, if the final stop count is less than this value, |
penalty |
Type: vehicle_shifts_penalty Penalties for shift constraints violation. |
preset_id |
Type: string Preset number for vehicle shift. |
service_duration_s |
Type: number Duration of service in between shifts (in seconds). It can include any operations needed to finish the shift, such as time to change a driver, exchange papers etc (default: 0). Max value: |
vehicle_specs
Vehicle specification. More information
Name |
Description |
height |
Type: number Height of the vehicle, meters. |
length |
Type: number Length of the vehicle, meters. |
max_weight |
Type: number Maximum weight of the vehicle, tons. |
max_weight_kg |
Type: number Maximum weight of the vehicle, kilograms. When solving the problem, the characteristic will be rounded up to tons.If both characteristics are set |
width |
Type: number Width of the vehicle, meters. |
vehicle_trailer
Trailer specification. Usage of trailer with walking_courier is forbidden.More information
Name |
Description |
capacity |
Type: vehicle_trailer_capacity Trailer capacity. |
cost |
Type: vehicle_trailer_cost Trailer cost. |
coupling_time_s |
Type: number Extra time to couple the trailer, seconds. Max value: |
decoupling_time_s |
Type: number Extra time to decouple the trailer, seconds. Max value: |
max_capacity_difference |
Type: vehicle_trailer_max_capacity_difference The maximum difference between the loading of the trailer and the head. |
rolling_cost |
Type: number Penalty for each rolling of goods from the trailer to the head. |
rolling_time |
Type: vehicle_trailer_rolling_time Time for loading shipments from trailer to head. In case multiple types of time are specified, the one that takes the most time is chosen. In case none of them is specified, only fixed loading time is used. |
vehicle_visited_locations_item
Name |
Description |
id* |
Type: integer or string Reference to a location specified in |
delivered_orders |
Type: (integer or string)[] List of IDs of orders delivered to the drop_off, depot or crossdock for delivery to the destination. |
order_ratio |
Type: number Order ratio, included in this part. |
shift_id |
Type: string Unique identifier of a shift. |
time |
Type: string Time of departure from a location, in |
wait_if_early |
Type: boolean This option determines what happens if a vehicle arrives to the planned location early. When Default: |
vehicle_walking_courier
Description of a pedestrian courier. Usage of walking_courier in vehicle with trailer is forbidden.
Name |
Description |
capacity |
Type: vehicle_walking_courier_capacity Capacity of a courier |
cost |
Type: vehicle_walking_courier_cost Courier work cost. |
restrictions |
detailed_cost_1_raw_metrics_item
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: detailed_cost_1_raw_metrics_raw_metrics_item[] The value of an arbitrary cost. |
subcosts |
Type: detailed_cost_1_raw_metrics_subcosts_item[] The value of an arbitrary cost. |
detailed_cost_1_subcosts_item
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: detailed_cost_1_subcosts_raw_metrics_item[] The value of an arbitrary cost. |
subcosts |
Type: detailed_cost_1_subcosts_subcosts_item[] The value of an arbitrary cost. |
mvrp_response_zones_geometry
Name |
Description |
coordinates |
Type: number[][][] Always consists of two elements: longitude and lattitude |
type |
Type: string Always equals |
dropped_locations_penalty_delivery_deadline
Penalty components for late deliveries from pickup
locations to depots. Whether the start or the end of service during the visit is used to penalize for lateness is determined by the penalize_late_service
option. More information
Name |
Description |
fixed |
Type: number Fixed penalty applied if the depot is visited after the deadline. Default: |
minute |
Type: number Penalty for each minute of lateness, when the depot is visited after the deadline. Default: |
dropped_locations_penalty_depot_expiring_time
Penalty components for violation soft_depot_expiring_time
restriction.
Name |
Description |
fixed |
Type: number Penalty for violation, regardless of the size of the violation. Default: |
minute |
Type: number Penalty for every minute of violation. Default: |
dropped_locations_penalty_depot_ready_time
Penalty components for violation soft_depot_ready_time
restriction.
Name |
Description |
fixed |
Type: number Penalty for violation, regardless of the size of the violation. Default: |
minute |
Type: number Penalty for every minute of violation. Default: |
penalty_drop_0_3
Name |
Description |
fixed |
Type: number Fixed penalty for not delivering any part of the order. |
scaled |
Type: number Penalty for not delivering order ratio. Default: |
dropped_locations_penalty_early
Penalty components for early service (used instead of out_of_time
penalty).
Name |
Description |
fixed |
Type: number Fixed penalty applied if the location starts being served before the start of the time window. Default: |
minute |
Type: number Penalty for each minute of early arrival when the location starts being served before the start of the time window. Default: |
dropped_locations_penalty_late
Penalty components for late visits (used instead of out_of_time
penalty). Whether the start or the end of service during the visit is used to penalize for lateness is determined by the penalize_late_service
option.
Name |
Description |
fixed |
Type: number Fixed penalty applied if the location is visited after the end of the time window. Default: |
minute |
Type: number Penalty for each minute of lateness, when the location is visited after the end of the time window. Default: |
dropped_locations_penalty_out_of_time
Penalty components for time window failure. Can be used to set the values of early
and late
options simultaneously, and each value is overridden if the respective option is also defined.
Name |
Description |
fixed |
Type: number Fixed penalty applied if the location is visited outside of the time window. See the specifications of Default: |
minute |
Type: number Penalty for each minute of lateness or early arrival when the location is visited outside of the time window. See the specifications of Default: |
dropped_locations_penalty_rolling_throughput
Penalty components for throughput exceeding.
Name |
Description |
fixed |
Type: number Fixed penalty applied if throughput is exceeded. Default: |
kg |
Type: number Penalty for each extra kg of throughput exceeding. Default: |
unit |
Type: number Penalty for each extra custom unit of throughput exceeding ( Default: |
vehicle |
Type: number Penalty for each extra vehicle per hour of throughput exceeding. Default: |
dropped_locations_penalty_throughput
Penalty components for throughput exceeding.
Name |
Description |
fixed |
Type: number Fixed penalty applied if throughput is exceeded. Default: |
kg |
Type: number Penalty for each extra kg of throughput exceeding. Default: |
unit |
Type: number Penalty for each extra custom unit of throughput exceeding ( Default: |
vehicle |
Type: number Penalty for each extra vehicle per hour of throughput exceeding. Default: |
dropped_locations_penalty_time_between_visits
Penalty components for exceeding max_time_between_visits_s
restriction.
Name |
Description |
fixed |
Type: number Penalty for each case of violation, regardless of the size of the violation. Default: |
minute |
Type: number Penalty for every minute of violation. Default: |
dropped_locations_penalty_transit_time
Penalty components for exceeding transit time
Name |
Description |
fixed |
Type: number Fixed penalty applied if the order was delivered with a violation of the soft transit time limit |
minute |
Type: number Penalty for each minute transit time violation |
rolling_throughput_kg_per_hour_0_item
Name |
Description |
time_window |
Type: string The time window during which the specified restriction applies. The windows must not intersect with each other, and their union must contain the defined working hours of the corresponding depot. If the restriction is not defined on any time interval outside depot working hours, then it is considered equal to zero. |
value |
Type: number Throughput, kilograms per hour. |
rolling_throughput_units_per_hour_0_item
Name |
Description |
time_window |
Type: string The time window during which the specified restriction applies. The windows must not intersect with each other, and their union must contain the defined working hours of the corresponding depot. If the restriction is not defined on any time interval outside depot working hours, then it is considered equal to zero. |
value |
Type: number Throughput, custom units per hour. |
rolling_throughput_vehicle_count_0_item
Name |
Description |
time_window |
Type: string The time window during which the specified restriction applies. The windows must not intersect with each other, and their union must contain the defined working hours of the corresponding depot. If the restriction is not defined on any time interval outside depot working hours, then it is considered equal to zero. |
value |
Type: number Throughput, simultaneously vehicles. Max value: |
dropped_locations_shipment_size_volume
Shipment dimensions and type.
Name |
Description |
depth_m* |
Type: number Depth, meters. Max value: |
height_m* |
Type: number Height, meters. Max value: |
width_m* |
Type: number Width, meters. Max value: |
align |
Type: string Defines allowed container alignment for
Default: Enum: |
type |
Type: string Container type:
Default: Enum: |
throughput_kg_per_hour_0_item
Name |
Description |
time_window |
Type: string The time window during which the specified restriction applies. The windows must not intersect with each other, and their union must contain the defined working hours of the corresponding depot. If the restriction is not defined on any time interval outside depot working hours, then it is considered equal to zero. |
value |
Type: number Throughput, kilograms per hour. |
throughput_units_per_hour_0_item
Name |
Description |
time_window |
Type: string The time window during which the specified restriction applies. The windows must not intersect with each other, and their union must contain the defined working hours of the corresponding depot. If the restriction is not defined on any time interval outside depot working hours, then it is considered equal to zero. |
value |
Type: number Throughput, custom units per hour. |
throughput_vehicle_count_0_item
Name |
Description |
time_window |
Type: string The time window during which the specified restriction applies. The windows must not intersect with each other, and their union must contain the defined working hours of the corresponding depot. If the restriction is not defined on any time interval outside depot working hours, then it is considered equal to zero. |
value |
Type: number Throughput, simultaneously vehicles. Max value: |
solver_options_1_balanced_groups_penalty
Penalties for imbalanced routes.
Name |
Description |
custom_value |
Type: number Penalty per each |
hour |
Type: number Penalty per hour of root-sum-square deviation of a route duration from an average duration of a balanced group of routes. |
ignore_unused_vehicles |
Type: boolean Ignore unused vehicles for the penalty calculation. |
km |
Type: number Penalty per km of root-sum-square deviation of a route distance from an average distance of a balanced group of routes. |
served_order |
Type: number Penalty per each missing or extra served order of root-sum-square deviation of a route served order count from an average number of served order in a balanced group of routes. |
stop |
Type: number Penalty per each missing or extra stop of root-sum-square deviation of a route stop count from an average number of stops in a balanced group of routes. |
unit |
Type: number Penalty per each unit of orders weight of root-sum-square deviation of a route unit of orders weight from an average number of unit of orders weight in a balanced group of routes. |
weight_kg |
Type: number Penalty per each kg of orders weight of root-sum-square deviation of a route kg of orders weight from an average number of kg of orders weight in a balanced group of routes. |
solver_options_1_penalty_close_location_groups
Penalty components for extra visits to close location group poins.
Name |
Description |
per_extra_point |
Type: number Penalty for every point where vehicles/couriers arrive more than once. |
per_extra_vehicle |
Type: number Penalty for every extra vehicle/courier that arrives at close location group points. |
per_extra_visit |
Type: number Penalty for each extra visit to close location group points. |
solver_options_1_penalty_drop_penalty_percentage
Penalty components for max_drop_penalty_percentage violation
.
Name |
Description |
fixed |
Type: number Fixed penalty applied if drop penalty ratio is too high. Default: |
per_percent |
Type: number Penalty for each exceeding percent of drop penalty percentage. Default: |
solver_options_1_penalty_multiorders
Penalty components for extra visits to multiorder poins.
Name |
Description |
per_extra_point |
Type: number Penalty for every point where vehicles/couriers arrive more than once. |
per_extra_vehicle |
Type: number Penalty for every extra vehicle/courier that arrives at multi-order points. |
per_extra_visit |
Type: number Penalty for each extra visit to multi-order points. |
solver_options_1_penalty_split_orders_percentage
Penalty components for max_split_orders_percentage violation
.
Name |
Description |
fixed |
Type: number Fixed penalty applied if split orders ratio is too high. Default: |
per_percent |
Type: number Penalty for each exceeding percent of split orders percentage. Default: |
solver_options_1_points_throughputs_penalty
Name |
Description |
throughput |
Type: points_throughputs_penalty_throughput Penalty components for throughput exceeding. |
solver_options_1_points_throughputs_point
WGS84 coordinate of a location. More information
Name |
Description |
lat* |
Type: number Min value: Max value: |
lon* |
Type: number Min value: Max value: |
solver_options_1_points_throughputs_throughput
Point throughput limit.
Name |
Description |
kg_per_hour |
Type: array or number |
units_per_hour |
Type: array or number |
vehicle_count |
Type: array or number |
template_rest_schedules_breaks_0_item
Work break.
Name |
Description |
rest_duration_s* |
Type: number Duration of rest, seconds. Min value: Max value: |
after_last_location |
Type: boolean When true, work break will be put after the last location. If possible it will be merged with the first work break of type listed in |
at_rest_place |
Type: boolean When true, the vehicle will break work only in a location with type "rest_place" |
before_first_location |
Type: boolean When true, work break will be put before the first location. If possible it will be merged with the last work break of type listed in |
continuous_travel_time_range |
Type: string Minimal and maximal duration of continuous travel time before rest, format: |
driving_time_range |
Type: string Minimal and maximal duration of driving before rest, format: |
exact_time_range |
Type: string The exact time range when the rest should start, format: |
merge_with_types |
Type: string[] Types of work breaks this work break can be merged with. This field can only be used with |
necessary_route_duration_s |
Type: number Minimal duration of route needed to make work break necessary, seconds. Max value: |
penalty |
Type: breaks_penalty Penalties applied for violations of work break conditions. |
repeatable |
Type: boolean When true, this work break will be repeated until the end of route. Can only be true for the last break in the chain. |
route_duration_s |
Type: number Minimal duration of route needed to use work break, seconds. Max value: |
travel_time_range |
Type: string Minimal and maximal duration of driving and waiting before rest, format: |
type |
Type: string Type of work break. Used in |
work_time_range_from_start |
Type: string Minimal and maximal duration of time from start of route until rest, format: |
work_time_range_till_rest |
Type: string Minimal and maximal duration of work before rest, format: |
route_node_depot
Route component.
Name |
Description |
type* |
Type: string Type of a route component. Enum: |
value* |
Type: route_depot_location Description of a location. |
used_hard_time_window |
Type: string Hard time window used to visit location or depot, in |
used_projection |
Type: route_node_depot_used_projection WGS84 coordinate of a location. More information |
used_time_window |
Type: string Time window used to visit location or depot, in |
route_node_location_1
Route component.
Name |
Description |
type* |
Type: string Type of a route component. Enum: |
value* |
Type: route_location_1 Description of a location. |
used_hard_time_window |
Type: string Hard time window used to visit location or depot, in |
used_projection |
Type: route_node_location_1_used_projection WGS84 coordinate of a location. More information |
used_time_window |
Type: string Time window used to visit location or depot, in |
route_node_work_break
Route component.
Name |
Description |
type* |
Type: string Type of a route component. Enum: |
value* |
Type: route_work_break Description of a work break. |
used_hard_time_window |
Type: string Hard time window used to visit location or depot, in |
used_projection |
Type: route_node_work_break_used_projection WGS84 coordinate of a location. More information |
used_time_window |
Type: string Time window used to visit location or depot, in |
route_node_courier_position
Route component.
Name |
Description |
type* |
Type: string Type of a route component. Enum: |
value* |
Type: route_courier_position |
used_hard_time_window |
Type: string Hard time window used to visit location or depot, in |
used_projection |
Type: route_node_courier_position_used_projection WGS84 coordinate of a location. More information |
used_time_window |
Type: string Time window used to visit location or depot, in |
route_element_1_failed_time_window
Name |
Description |
duration_s* |
Type: number When a location is visited outside of the time window, indicates the duration (in seconds) between the reference time and the closest endpoint of the failed time window. The reference time is the start or the end of service depending on |
how* |
Type: string When a location is visited outside of the time window, indicates the time direction between the arrival time and the failed time window:
Enum: |
route_element_1_overtime
Name |
Description |
duration_s* |
Type: number Vehicle shift overtime in seconds. |
route_element_1_probably_failed_time_window
Name |
Description |
duration_s* |
Type: number Expected difference between arrival time and failing time window, seconds. |
how* |
Type: string When a location is visited outside of the time window, indicates the time direction between the arrival time and the failed time window:
Enum: |
probability* |
Type: number Probability of being outside of the time window, percent. |
high_risk |
Type: boolean When true, it means that probability of being late on location is greater or equal to |
route_element_1_violations_0
Name |
Description |
duration_s* |
Type: number Expected difference between arrival time and the deadline, seconds. |
pickup_id* |
Type: integer or string Defines |
type* |
Type: string Possible reasons:
Enum: |
route_element_1_violations_1
Name |
Description |
duration_s* |
Type: number Expected difference between arrival time and the deadline, seconds. |
high_risk* |
Type: boolean When true, it means that probability of being late on location is greater or equal to |
pickup_id* |
Type: integer or string Defines |
probability* |
Type: number Probability of being late, percent. |
type* |
Type: string Possible reasons:
Enum: |
routes_global_proximity_attraction_point_optional_tags_item
An optional tag with bonus or penalty.
Name |
Description |
tag* |
Type: string An arbitrary tag. |
value* |
Type: number Value of the tag. When location is served by a vehicle with a matching tag in |
routes_global_proximity_attraction_point_penalty_1
Penalties for non-completion and time window failure. More information
Name |
Description |
delivery_deadline |
Type: global_proximity_attraction_point_penalty_delivery_deadline Penalty components for late deliveries from |
depot_expiring_time |
Type: global_proximity_attraction_point_penalty_depot_expiring_time Penalty components for violation |
depot_ready_time |
Type: global_proximity_attraction_point_penalty_depot_ready_time Penalty components for violation |
drop |
Type: global_proximity_attraction_point_penalty_drop_0_1 or number Penalty for not delivering an order. More information |
early |
Type: global_proximity_attraction_point_penalty_early Penalty components for early service (used instead of |
late |
Type: global_proximity_attraction_point_penalty_late Penalty components for late visits (used instead of |
out_of_time |
Type: global_proximity_attraction_point_penalty_out_of_time Penalty components for time window failure. Can be used to set the values of |
rolling_throughput |
Type: global_proximity_attraction_point_penalty_rolling_throughput Penalty components for throughput exceeding. |
throughput |
Type: global_proximity_attraction_point_penalty_throughput Penalty components for throughput exceeding. |
time_between_visits |
Type: global_proximity_attraction_point_penalty_time_between_visits Penalty components for exceeding |
transit_time |
Type: global_proximity_attraction_point_penalty_transit_time Penalty components for exceeding transit time |
global_proximity_attraction_point_quant_0_1
Minimal part which can be split from the order measured in one of the units
Name |
Description |
units |
Type: number Size of shipment in custom units. |
volume_cbm |
Type: number Volume of minimal part, cubic meters. |
weight_kg |
Type: number Weight of minimal part, kilograms. |
routes_global_proximity_attraction_point_rolling_throughput
Rolling throughput limit (supported for anchors).
Name |
Description |
kg_per_hour |
Type: array or number |
units_per_hour |
Type: array or number |
vehicle_count |
Type: array or number |
routes_global_proximity_attraction_point_shipment_size
Shipment size (dimensions and/or weight). More information
Name |
Description |
custom |
Type: number Size of shipment in custom units. Sizes in custom units are defined in format |
units |
Type: number Size of shipment in custom units. Max value: |
volume |
Type: global_proximity_attraction_point_shipment_size_volume Shipment dimensions and type. |
volume_cbm |
Type: number Explicit volume, cubic meters. By default, the value is taken from "volume", if nothing is specified here. |
weight_kg |
Type: number Weight of shipment, kilograms. Max value: |
routes_global_proximity_attraction_point_throughput
Location throughput limit (supported for the orders which can be split).
Name |
Description |
kg_per_hour |
Type: array or number |
units_per_hour |
Type: array or number |
vehicle_count |
Type: array or number |
routes_global_proximity_attraction_point_time_windows_item
Name |
Description |
time_window* |
Type: string Allowed time window to visit location, in |
hard_time_window |
Type: string Allowed hard time window to visit location, in |
routes_global_proximity_attraction_point_transit_time
Restrictions on the time the order spends inside a vehicle
Name |
Description |
hard_limit_s |
Type: number Hard time limit, values above it are unacceptable Max value: |
limit_s |
Type: number Soft time limit, values above it are acceptable but they will be penalized Max value: |
routes_shift_end_1
Route node, contains information about a visited location or a work break, transit information and arrival time.
Name |
Description |
arrival_time_s* |
Type: number Arrival time at the location. Arrival happened before the start of the time window, will incur waiting time. |
node* |
Type: route_node_depot or route_node_location_1 or route_node_work_break or route_node_courier_position Route component. |
transit_distance_m* |
Type: number Transit distance to a location, meters. If routing_mode is set to "transit", only pedestrian distance part of the route is considered. |
transit_duration_s* |
Type: number Transit time to a location, seconds. |
actual_arrival_time_s |
Type: number Actual arrival time at the location. |
actual_departure_time_s |
Type: number Actual time of departure from the location. |
actual_service_start_time_s |
Type: number Actual time of service start in the location. |
actual_waiting_duration_s |
Type: number Waiting duration, time spent at location after arrival and before the start of the time window, seconds. |
departure_time_s |
Type: number Time of departure from the location. |
failed_time_window |
|
load_to_head |
Type: (integer or string)[] List of orders that should be loaded to the head of the vehicle at depot or anchor location, in case trailers are used. Orders are listed in the order of serving. |
load_to_trailer |
Type: (integer or string)[] List of orders that should be loaded to the trailer of the vehicle at depot, in case trailers are used. Orders are listed in the order of serving. |
multi_order |
Type: boolean An order is one of several orders at exactly the same location which are served together. Arrival time is the same for all orders in the group, also the orders share |
overtime |
Type: shift_end_overtime |
probably_failed_time_window |
|
stop_sequence_number |
Type: integer Sequence number of a stop (among delivery, pickup and drop_off locations) |
violations |
Type: (end_violations_0_1 or end_violations_1_1)[] List of violations. |
waiting_duration_s |
Type: number Waiting duration, time spent at location after arrival and before the start of the time window, seconds. |
routes_shift_start_1
Route node, contains information about a visited location or a work break, transit information and arrival time.
Name |
Description |
arrival_time_s* |
Type: number Arrival time at the location. Arrival happened before the start of the time window, will incur waiting time. |
node* |
Type: route_node_depot or route_node_location_1 or route_node_work_break or route_node_courier_position Route component. |
transit_distance_m* |
Type: number Transit distance to a location, meters. If routing_mode is set to "transit", only pedestrian distance part of the route is considered. |
transit_duration_s* |
Type: number Transit time to a location, seconds. |
actual_arrival_time_s |
Type: number Actual arrival time at the location. |
actual_departure_time_s |
Type: number Actual time of departure from the location. |
actual_service_start_time_s |
Type: number Actual time of service start in the location. |
actual_waiting_duration_s |
Type: number Waiting duration, time spent at location after arrival and before the start of the time window, seconds. |
departure_time_s |
Type: number Time of departure from the location. |
failed_time_window |
|
load_to_head |
Type: (integer or string)[] List of orders that should be loaded to the head of the vehicle at depot or anchor location, in case trailers are used. Orders are listed in the order of serving. |
load_to_trailer |
Type: (integer or string)[] List of orders that should be loaded to the trailer of the vehicle at depot, in case trailers are used. Orders are listed in the order of serving. |
multi_order |
Type: boolean An order is one of several orders at exactly the same location which are served together. Arrival time is the same for all orders in the group, also the orders share |
overtime |
Type: shift_start_overtime |
probably_failed_time_window |
|
stop_sequence_number |
Type: integer Sequence number of a stop (among delivery, pickup and drop_off locations) |
violations |
Type: (start_violations_0_1 or start_violations_1_1)[] List of violations. |
waiting_duration_s |
Type: number Waiting duration, time spent at location after arrival and before the start of the time window, seconds. |
vehicle_capacity_limits
Vehicle load limits.
Name |
Description |
units_perc |
Type: number Upper limit of total shipments size in custom units as a percentage of a vehicle capacity. Default: |
volume_perc |
Type: number Upper limit of total shipments volume as a percentage of vehicle load bay volume. For container fitting purposes it is assumed that each dimension is multiplied by the cubic root of Default: |
weight_perc |
Type: number Upper limit of total shipments weight as a percentage of total weight the vehicle is allowed to carry. Default: |
vehicle_capacity_volume
Vehicle dimensions.
Name |
Description |
depth_m* |
Type: number Depth, meters. Default: Max value: |
height_m* |
Type: number Height, meters. Default: Max value: |
width_m* |
Type: number Width, meters. Default: Max value: |
vehicle_close_locations_distance_till_service_m
Name |
Description |
penalty |
Type: number Penalty per km exceeding the maximum distance between servicing close locations. Max value: |
value |
Type: number The maximum distance traveled between servicing two close locations. Default: Max value: |
vehicle_close_locations_duration_till_service_s
Name |
Description |
penalty |
Type: number Penalty per second exceeding the maximum time between servicing close locations. Max value: |
value |
Type: number The maximum time between servicing two close locations. Default: Max value: |
vehicle_penalty_arrival_after_start
Penalty components for arrived after start of timewindow
Name |
Description |
as_soon_as_possible |
Type: boolean Option for arrive as soon as possible even it includes added wait in route. When using the parameter, it is also recommended to specify a non-zero value of the |
average_h |
Type: number Penalty for average arrived after start of timewindow |
vehicle_penalty_empty_runs
Penalty components for empty runs, which cannot be skipped because of actual visit times.
Name |
Description |
fixed |
Type: number Fixed penalty applied if there are empty runs left in the route. |
per_run |
Type: number Penalty for every empty run in the route. |
vehicle_penalty_min_stop_weight
Penalty components for insufficient total orders weight in point.
Name |
Description |
fixed |
Type: number Fixed penalty applied if total orders weight is too low. Default: |
kg |
Type: number Penalty for each lacking kg of total orders weight. Default: |
vehicle_planned_route_locations_item
Name |
Description |
id* |
Type: integer or string Reference to a location specified in |
anchor_mode |
Type: string Default: Enum: |
delivered_orders |
Type: (integer or string)[] List of IDs of orders delivered to the drop_off, depot or crossdock for delivery to the destination. |
delivery_in_current_run |
Type: boolean All orders, loaded in this location, have to be delivered in current run. |
is_middle_depot |
Type: boolean Location is a middle depot. |
loaded_orders |
Type: (integer or string)[] Ids of |
order_ratio |
Type: number Order ratio, included in this part. |
parking_mode |
Type: string Default: Enum: |
picked_orders |
Type: (integer or string)[] A list of IDs of orders picked up in the crossdock or depot. |
shift_id |
Type: string Unique identifier of a shift. |
wait_if_early |
Type: boolean This option determines what happens if a vehicle arrives to the planned location early. When Default: |
vehicle_planned_route_start_time_0_item
Name |
Description |
shift_id* |
Type: string Unique identifier of a shift. |
start_time* |
Type: string Shift start time, in |
vehicle_planned_route_work_breaks_item
Name |
Description |
work_duration_s* |
Type: number Duration of continuous work before the break, seconds. Max value: |
shift_id |
Type: string Unique identifier of a shift. |
vehicle_rest_schedule_breaks_0_item
Work break.
Name |
Description |
rest_duration_s* |
Type: number Duration of rest, seconds. Min value: Max value: |
after_last_location |
Type: boolean When true, work break will be put after the last location. If possible it will be merged with the first work break of type listed in |
at_rest_place |
Type: boolean When true, the vehicle will break work only in a location with type "rest_place" |
before_first_location |
Type: boolean When true, work break will be put before the first location. If possible it will be merged with the last work break of type listed in |
continuous_travel_time_range |
Type: string Minimal and maximal duration of continuous travel time before rest, format: |
driving_time_range |
Type: string Minimal and maximal duration of driving before rest, format: |
exact_time_range |
Type: string The exact time range when the rest should start, format: |
merge_with_types |
Type: string[] Types of work breaks this work break can be merged with. This field can only be used with |
necessary_route_duration_s |
Type: number Minimal duration of route needed to make work break necessary, seconds. Max value: |
penalty |
Type: breaks_penalty Penalties applied for violations of work break conditions. |
repeatable |
Type: boolean When true, this work break will be repeated until the end of route. Can only be true for the last break in the chain. |
route_duration_s |
Type: number Minimal duration of route needed to use work break, seconds. Max value: |
travel_time_range |
Type: string Minimal and maximal duration of driving and waiting before rest, format: |
type |
Type: string Type of work break. Used in |
work_time_range_from_start |
Type: string Minimal and maximal duration of time from start of route until rest, format: |
work_time_range_till_rest |
Type: string Minimal and maximal duration of work before rest, format: |
vehicle_shifts_penalty
Penalties for shift constraints violation.
Name |
Description |
early |
Type: shifts_penalty_early Penalty components for shifts started too early (used instead of |
late |
Type: shifts_penalty_late Penalty components for shifts finished too late (used instead of |
max_mileage |
Type: shifts_penalty_max_mileage Penalties applied for violating shift's |
out_of_time |
Type: shifts_penalty_out_of_time Penalty components for time window failure. Can be used to set the values of |
stop_excess |
Type: shifts_penalty_stop_excess Penalties applied for violating shift's |
stop_lack |
Type: shifts_penalty_stop_lack Penalties applied for violating shift's |
unique_stop_lack |
Type: shifts_penalty_unique_stop_lack Penalties applied for violating shift's |
vehicle_trailer_capacity
Trailer capacity.
Name |
Description |
custom |
Type: number Amount of custom units a trailer is able to carry. Capacities in custom units are defined in format |
limits |
Type: trailer_capacity_limits Trailer load limits. |
units |
Type: number Amount of custom units a trailer is able to carry. Default: |
volume |
Type: trailer_capacity_volume Trailer dimensions. |
volume_cbm |
Type: number Volume a trailer is able to fit, cubic meters. |
weight_kg |
Type: number Weight a trailer is able to carry, kilograms. Default: |
vehicle_trailer_cost
Trailer cost.
Name |
Description |
fixed |
Type: number Cost per fact of trailer use (cost occurred if trailer is used in route). Default: |
hour |
Type: number Cost of using trailer per hour. Default: |
km |
Type: number Cost of using trailer per kilometer. Default: |
location |
Type: number Cost of using trailer per location (default 0). |
run |
Type: number Cost per single vehicle run from depot to locations. |
tonne_km |
Type: number Cost of carrying one tonne for one kilometer (default 0). |
waiting_hour |
Type: number Cost of waiting per hour. If not defined, the value specified in the |
vehicle_trailer_max_capacity_difference
The maximum difference between the loading of the trailer and the head.
Name |
Description |
custom |
Type: number A maximum allowable difference in the loaded amount of custom units between the trailer and the head. The difference in custom units are defined in format |
units |
Type: number The maximum allowable difference in the loaded amount of custom units between the trailer and the head. |
volume_cbm |
Type: number The maximum allowable difference in the loaded volume between the trailer and the head, cubic meters. |
weight_kg |
Type: number The maximum allowable difference in the loaded weight between the trailer and the head, kilograms. |
vehicle_trailer_rolling_time
Time for loading shipments from trailer to head. In case multiple types of time are specified, the one that takes the most time is chosen. In case none of them is specified, only fixed loading time is used.
Name |
Description |
fixed_time_s |
Type: number Fixed time spent each time a trailer is loaded or unloaded, seconds. Max value: |
s_per_kg |
Type: number Loading time per kg, seconds. Max value: |
s_per_m3 |
Type: number Loading time per cubic meter, seconds. Max value: |
s_per_unit |
Type: number Loading time per unit, seconds. Max value: |
vehicle_walking_courier_capacity
Capacity of a courier
Name |
Description |
units |
Type: number Amount of custom units a courier is able to carry. Default: |
vehicle_walking_courier_cost
Courier work cost.
Name |
Description |
hour |
Type: number Cost per hour of courier walking routes. |
km |
Type: number Cost per kilometer walked by courier. |
vehicle_walking_courier_restrictions
Name |
Description |
max_parking_duration_s |
|
max_parking_walking_distance_m |
Type: walking_courier_restrictions_max_parking_walking_distance_m |
max_walking_edge_distance_m |
Type: walking_courier_restrictions_max_walking_edge_distance_m |
detailed_cost_1_raw_metrics_raw_metrics_item
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: raw_metrics_raw_metrics_item_14[] The value of an arbitrary cost. |
subcosts |
Type: raw_metrics_subcosts_item_12[] The value of an arbitrary cost. |
detailed_cost_1_raw_metrics_subcosts_item
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: subcosts_raw_metrics_item_11[] The value of an arbitrary cost. |
subcosts |
Type: subcosts_subcosts_item_10[] The value of an arbitrary cost. |
detailed_cost_1_subcosts_raw_metrics_item
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: raw_metrics_raw_metrics_item_7[] The value of an arbitrary cost. |
subcosts |
Type: raw_metrics_subcosts_item_5[] The value of an arbitrary cost. |
detailed_cost_1_subcosts_subcosts_item
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: subcosts_raw_metrics_item_4[] The value of an arbitrary cost. |
subcosts |
Type: subcosts_subcosts_item_3[] The value of an arbitrary cost. |
points_throughputs_penalty_throughput
Penalty components for throughput exceeding.
Name |
Description |
fixed |
Type: number Fixed penalty applied if throughput is exceeded. Default: |
kg |
Type: number Penalty for each extra kg of throughput exceeding. Default: |
unit |
Type: number Penalty for each extra custom unit of throughput exceeding ( Default: |
vehicle |
Type: number Penalty for each extra vehicle per hour of throughput exceeding. Default: |
breaks_penalty
Penalties applied for violations of work break conditions.
Name |
Description |
early |
Type: penalty_early Penalty components for early work break. |
late |
Type: penalty_late Penalty components for late work break. |
route_depot_location
Description of a location.
Name |
Description |
id* |
Type: integer or string Location ID. All locations IDs in task must be unique and have the same type: integer or string. More information |
actual_total_service_duration_s |
Type: number Actual total duration of service at a location (according to actual_arrival_time_s and actual_departure_time_s). |
address |
Type: string Address of the location. |
crossdock_safety_waiting_duration_s |
Type: number The duration of the minimum time interval between the moment the order arrives at the cross-dock depot and the moment when it can be picked up from there by a vehicle for delivery. This interval is needed so that there is a reserve of time in case the vehicle that brings the orders is late. Default: Max value: |
delivered_orders |
Type: (integer or string)[] List of IDs of orders delivered to the drop_off, depot or crossdock for delivery to the destination. |
description |
Type: string Location description. |
finish_service_duration_s |
Type: number Duration of service at a depot in the end of a route. Finish service duration can include any operations at depot, e.g. unloading items, documents collection etc. More information Max value: |
fixed_position |
Type: boolean It is not allowed to move location or insert other locations before it |
flexible_start_time |
Type: boolean By default vehicle start time is equal to either depot, or garage, or shift start time. When this option is set to true, vehicles can start earlier or later than the default start time. In this case the optimal start time will be computed according to cost minimization. More information
Also when |
hard_time_window |
Type: string Allowed hard time window to visit location, in |
hard_window |
Type: boolean Restricts time window relaxation during route planning. When true, vehicles are allowed to return to depot only within the specified time window. More information |
load_service_duration_s |
Type: number Additional duration for loading delivery orders into a vehicle, added only if there is at least one delivery order,loaded in this depot. |
loaded_orders |
Type: (integer or string)[] Ids of |
package_throughput |
Type: route_depot_location_package_throughput Restriction on packaging speed in depot. |
penalty |
Type: route_depot_location_penalty Penalties for depot time window or throughput failure. More information |
picked_orders |
Type: (integer or string)[] A list of IDs of orders picked up in the crossdock or depot. |
point |
Type: coordinate_2 WGS84 coordinate of a location. More information |
preliminary_service_duration_s |
Type: number Duration of preliminary service at depot. This duration can include any operations that can be done before loading the vehicle. These operations will be done before Max value: |
preset_id |
Type: string Preset number for depot properties. |
ref |
Type: string Location reference. |
routing_mode |
Type: string The transportation method used to reach this location. Enum: |
service_duration_s |
Type: service_duration_2_0 or number Duration of service at location. Service duration can include any operations at location, such as loading or unloading items from a vehicle, or any other time associated with a location (apart from waiting, which is time after arrival and before service).More information |
throughput |
Type: route_depot_location_throughput Depot throughput limit. More information |
time_window |
Type: string Allowed time window to visit location, in |
time_windows |
Type: route_depot_location_time_windows_item[] List of allowed time windows. Time windows can not overlap. Fields |
time_windows_loading |
Type: route_depot_location_time_windows_loading Time windows when the vehicle is allowed to leave the depot on the 1st run |
time_windows_refilling |
Type: route_depot_location_time_windows_refilling Time windows when the vehicle is allowed to visit a depot (or middle depot) for additional loading |
time_windows_unloading |
Type: route_depot_location_time_windows_unloading Time windows when the vehicle is allowed to return to the depot on the last run |
title |
Type: string Location title. |
total_service_duration_s |
Type: number Total duration of service at a depot (equals to Max value: |
trailer_decoupled |
Type: boolean |
trailer_used |
Type: boolean |
type |
Type: string Defines a type of depot:
Default: Enum: |
unfeasible_reasons |
Type: (route_depot_location_unfeasible_reasons_0 or route_depot_location_unfeasible_reasons_1 or route_depot_location_unfeasible_reasons_2)[] List of unfeasible reasons. |
unload_service_duration_s |
Type: number Additional duration for unloading pickup orders from a vehicle, added only if there is at least one pickup order,delivered in this depot. |
use_in_proximity |
Type: boolean When |
route_node_depot_used_projection
WGS84 coordinate of a location. More information
Name |
Description |
lat* |
Type: number Min value: Max value: |
lon* |
Type: number Min value: Max value: |
route_location_1
Description of a location.
Name |
Description |
id* |
Type: integer or string Location ID. All locations IDs in task must be unique and have the same type: integer or string. More information |
actual_total_service_duration_s |
Type: number Actual total duration of service at a location (according to actual_arrival_time_s and actual_departure_time_s). |
added_shared_service_duration_s |
Type: number Added duration of shared service, for first order in multi-order equals to shared_service_duration_sFor other orders in multi-order maybe non-zero,if shared_service_duration_s of current order is more than shared_service_duration_s of previous orders Max value: |
address |
Type: string Address of the location. |
allow_trailers |
Type: boolean When |
anchor_mode |
Type: string Default: Enum: |
can_be_merged |
Type: boolean An order can be a part of multiorder Default: |
can_be_split |
Type: boolean An order can be split into parts between different vehicles. |
client_id |
Type: integer or string Defines |
client_service_duration_s |
Type: client_service_duration_0 or number Duration of service at a location, which can be shared among the other orders of the same client (by client_id) at exactly the same location. |
comments |
Type: string Comments. |
crossdock_mode |
Type: string Defines whether it is allowed to deliver this order through a cross-dock depot.
Default: Enum: |
crossdock_service_duration_s |
Type: crossdock_service_duration_0 or number Time spent at a crossdock location during the unloading of this order. More information |
custom_value |
Type: number A custom numeric value, associated with location (E.g. the reward for the courier for visiting this location). May be used as a component in vehicle cost function. |
delivered_orders |
Type: (integer or string)[] List of IDs of orders delivered to the drop_off, depot or crossdock for delivery to the destination. |
delivery_deadline |
Type: string Time by which the |
delivery_to |
Type: integer or string Defines |
delivery_to_any |
Type: (integer or string)[] A list of |
depot_duration_s |
Type: depot_duration_0 or number Time spent at a depot during handling of this location (goods loading, document collection, etc.). More information |
depot_expiring_time |
Type: string Time by which the order must be taken from the depot, in |
depot_id |
Type: integer or string or array |
depot_ready_time |
Type: string Time when the order is ready to be taken from any depot, in |
description |
Type: string Location description. |
drop_reason |
Type: string Explanation why the location was dropped. |
dropped_ratio |
Type: number Order ratio which have to stay in drop Max value: |
fixed_position |
Type: boolean It is not allowed to move location or insert other locations before it |
fixed_run |
Type: boolean Order can only be added in the run in which it was planned |
fixed_shift |
Type: boolean Order can only be added in the shift in which it was planned |
fixed_vehicle |
Type: boolean Order can only be taken by the vehicle in which it was planned |
hard_time_window |
Type: string Allowed hard time window to visit location, in |
hard_window |
Type: boolean Restricts time window relaxation during route planning. If location cannot be visited within a specified time window, it will be excluded from the route and added to |
ignore_zones_compatibility |
Type: boolean Ignore the effects caused by the |
in_lifo_order |
Type: boolean Orders with this field set to |
keep_in_vehicle |
Type: boolean When order is dropped it still takes space in the vehicle |
load_types |
Type: string[] Defines types of location load.
mustn |
loaded_orders |
Type: (integer or string)[] Ids of |
max_split_parts |
Type: integer Maximal number of parts in which the order can be split Default: Min value: |
max_total_vehicles |
Type: integer Maximal number of vehicles that can be served by an anchor location. Unlimited by default. More information |
may_drop_in_crossdock |
Type: boolean May drop pickup order in crossdock location Default: |
optional_tags |
Type: route_location_1_optional_tags_item[] List of tags which are not required for a vehicle to serve the location, but they can decrease or increase the route cost if satisfied. More information |
parking_mode |
Type: string Type of the parking node Enum: |
parking_service_duration_s |
Type: number Duration of parking at location. If the order is delivered using Max value: |
parking_type |
Type: string Enum: |
penalty |
Type: route_location_1_penalty Penalties for non-completion and time window failure. More information |
phone |
Type: string Phone number of delivery receiver. |
picked_orders |
Type: (integer or string)[] A list of IDs of orders picked up in the crossdock or depot. |
pickup_from_any |
Type: boolean Delivery-orders that have this field set to |
pickup_id |
Type: integer or string ID of a pickup corresponding to this delivery. |
pickup_ids |
Type: (integer or string)[] List of IDs of pickups corresponding to this delivery. |
pickup_must_reach_depot |
Type: boolean The field determines whether the pickup is considered serviced if it is not delivered depot. The field shouldnt be defined for types other than pickup. The field is mutually exclusive with fields |
point |
Type: coordinate_2 WGS84 coordinate of a location. More information |
preset_id |
Type: string Preset number for location properties. |
quant |
Type: number or route_location_1_quant_0 |
ref |
Type: string Location reference. |
required_tags |
Type: string[] List of tags a vehicle must have to arrive at the location. More information |
rolling_throughput |
Type: route_location_1_rolling_throughput Rolling throughput limit (supported for anchors). |
routing_mode |
Type: string The transportation method used to reach this location. Enum: |
sequence_order |
Type: integer All locations in vehicle route with specified sequence_order option have to be visited in non-decreasing order of its values. More information |
service_duration_s |
Type: service_duration_2_0 or number Duration of service at location. Service duration can include any operations at location, such as loading or unloading items from a vehicle, or any other time associated with a location (apart from waiting, which is time after arrival and before service).More information |
service_durations |
Type: service_durations Structure storing location service durations. |
service_waiting_duration_s |
Type: number Duration of waiting for service at a location. It can be non-zero when, for example, an order is a part of a multi-order, in this case waiting duration includes duration of service of the other orders from the multi-order. Max value: |
shared_service_duration_s |
Type: shared_service_duration_0 or number Duration of service at a location, which can be shared among the other orders at exactly the same location. Shared service duration can include such operations as parking of a car, delivering documents, etc. More information |
shared_with_company_ids |
Type: integer[] IDs of the companies that can access the order information. |
shipment_size |
Type: route_location_1_shipment_size Shipment size (dimensions and/or weight). More information |
soft_depot_expiring_time |
Type: string Time by which the order must be taken from the depot, in |
soft_depot_ready_time |
Type: string Time when the order is ready to be taken from any depot, in |
split_info |
Type: route_location_1_split_info Information about split part of the order (in case if the order was split) |
split_parts_must_fill_whole_vehicle |
Type: boolean Parts, split from a splittable order, should fill the whole vehicle. |
throughput |
Type: route_location_1_throughput Location throughput limit (supported for the orders which can be split). |
time_window |
Type: string Allowed time window to visit location, in |
time_windows |
Type: route_location_1_time_windows_item[] List of allowed time windows. Time windows can not overlap. Fields |
title |
Type: string Location title. |
total_service_duration_s |
Type: number Total duration of service at a location, it includes Max value: |
trailer_decoupled |
Type: boolean |
trailer_used |
Type: boolean |
transit_time |
Type: route_location_1_transit_time Restrictions on the time the order spends inside a vehicle |
type |
Type: string Defines a type of service at the location:
Default: Enum: |
undroppable |
Type: boolean Location cannot be dropped |
unfeasible_reasons |
Type: (route_location_1_unfeasible_reasons_0 or route_location_1_unfeasible_reasons_1 or route_location_1_unfeasible_reasons_2 or route_location_1_unfeasible_reasons_3 or route_location_1_unfeasible_reasons_4 or route_location_1_unfeasible_reasons_5 or route_location_1_unfeasible_reasons_6 or route_location_1_unfeasible_reasons_7 or route_location_1_unfeasible_reasons_8 or route_location_1_unfeasible_reasons_9)[] List of unfeasible reasons. |
use_in_proximity |
Type: boolean When Default: |
route_node_location_1_used_projection
WGS84 coordinate of a location. More information
Name |
Description |
lat* |
Type: number Min value: Max value: |
lon* |
Type: number Min value: Max value: |
route_work_break
Description of a work break.
Name |
Description |
rest_duration_s* |
Type: number Duration of rest, seconds. Min value: Max value: |
after_last_location |
Type: boolean When true, work break will be put after the last location. If possible it will be merged with the first work break of type listed in |
at_rest_place |
Type: boolean When true, the vehicle will break work only in a location with type "rest_place" |
before_first_location |
Type: boolean When true, work break will be put before the first location. If possible it will be merged with the last work break of type listed in |
chain_number |
Type: integer Sequential number of a work break chain to which the break belongs. |
continuous_travel_time_range |
Type: string Minimal and maximal duration of continuous travel time before rest, format: |
driving_time_range |
Type: string Minimal and maximal duration of driving before rest, format: |
exact_time_range |
Type: string The exact time range when the rest should start, format: |
fixed_position |
Type: boolean It is not allowed to move location or insert other locations before it |
merge_with_types |
Type: string[] Types of work breaks this work break can be merged with. This field can only be used with |
necessary_route_duration_s |
Type: number Minimal duration of route needed to make work break necessary, seconds. Max value: |
penalty |
Type: route_work_break_penalty Penalties applied for violations of work break conditions. |
repeatable |
Type: boolean When true, this work break will be repeated until the end of route. Can only be true for the last break in the chain. |
route_duration_s |
Type: number Minimal duration of route needed to use work break, seconds. Max value: |
travel_time_range |
Type: string Minimal and maximal duration of driving and waiting before rest, format: |
type |
Type: string Type of work break. Used in |
work_duration_s |
Type: number Duration of continuous work before the break, seconds. Max value: |
work_time_range_from_start |
Type: string Minimal and maximal duration of time from start of route until rest, format: |
work_time_range_till_rest |
Type: string Minimal and maximal duration of work before rest, format: |
route_node_work_break_used_projection
WGS84 coordinate of a location. More information
Name |
Description |
lat* |
Type: number Min value: Max value: |
lon* |
Type: number Min value: Max value: |
route_courier_position
Name |
Description |
location_id* |
Type: string Id of current location |
passed_time_s |
Type: number Time passed after courier leave current location. Consider that courier has not yet arrived to the next location. |
route_node_courier_position_used_projection
WGS84 coordinate of a location. More information
Name |
Description |
lat* |
Type: number Min value: Max value: |
lon* |
Type: number Min value: Max value: |
global_proximity_attraction_point_penalty_delivery_deadline
Penalty components for late deliveries from pickup
locations to depots. Whether the start or the end of service during the visit is used to penalize for lateness is determined by the penalize_late_service
option. More information
Name |
Description |
fixed |
Type: number Fixed penalty applied if the depot is visited after the deadline. Default: |
minute |
Type: number Penalty for each minute of lateness, when the depot is visited after the deadline. Default: |
global_proximity_attraction_point_penalty_depot_expiring_time
Penalty components for violation soft_depot_expiring_time
restriction.
Name |
Description |
fixed |
Type: number Penalty for violation, regardless of the size of the violation. Default: |
minute |
Type: number Penalty for every minute of violation. Default: |
global_proximity_attraction_point_penalty_depot_ready_time
Penalty components for violation soft_depot_ready_time
restriction.
Name |
Description |
fixed |
Type: number Penalty for violation, regardless of the size of the violation. Default: |
minute |
Type: number Penalty for every minute of violation. Default: |
global_proximity_attraction_point_penalty_drop_0_1
Name |
Description |
fixed |
Type: number Fixed penalty for not delivering any part of the order. |
scaled |
Type: number Penalty for not delivering order ratio. Default: |
global_proximity_attraction_point_penalty_early
Penalty components for early service (used instead of out_of_time
penalty).
Name |
Description |
fixed |
Type: number Fixed penalty applied if the location starts being served before the start of the time window. Default: |
minute |
Type: number Penalty for each minute of early arrival when the location starts being served before the start of the time window. Default: |
global_proximity_attraction_point_penalty_late
Penalty components for late visits (used instead of out_of_time
penalty). Whether the start or the end of service during the visit is used to penalize for lateness is determined by the penalize_late_service
option.
Name |
Description |
fixed |
Type: number Fixed penalty applied if the location is visited after the end of the time window. Default: |
minute |
Type: number Penalty for each minute of lateness, when the location is visited after the end of the time window. Default: |
global_proximity_attraction_point_penalty_out_of_time
Penalty components for time window failure. Can be used to set the values of early
and late
options simultaneously, and each value is overridden if the respective option is also defined.
Name |
Description |
fixed |
Type: number Fixed penalty applied if the location is visited outside of the time window. See the specifications of Default: |
minute |
Type: number Penalty for each minute of lateness or early arrival when the location is visited outside of the time window. See the specifications of Default: |
global_proximity_attraction_point_penalty_rolling_throughput
Penalty components for throughput exceeding.
Name |
Description |
fixed |
Type: number Fixed penalty applied if throughput is exceeded. Default: |
kg |
Type: number Penalty for each extra kg of throughput exceeding. Default: |
unit |
Type: number Penalty for each extra custom unit of throughput exceeding ( Default: |
vehicle |
Type: number Penalty for each extra vehicle per hour of throughput exceeding. Default: |
global_proximity_attraction_point_penalty_throughput
Penalty components for throughput exceeding.
Name |
Description |
fixed |
Type: number Fixed penalty applied if throughput is exceeded. Default: |
kg |
Type: number Penalty for each extra kg of throughput exceeding. Default: |
unit |
Type: number Penalty for each extra custom unit of throughput exceeding ( Default: |
vehicle |
Type: number Penalty for each extra vehicle per hour of throughput exceeding. Default: |
global_proximity_attraction_point_penalty_time_between_visits
Penalty components for exceeding max_time_between_visits_s
restriction.
Name |
Description |
fixed |
Type: number Penalty for each case of violation, regardless of the size of the violation. Default: |
minute |
Type: number Penalty for every minute of violation. Default: |
global_proximity_attraction_point_penalty_transit_time
Penalty components for exceeding transit time
Name |
Description |
fixed |
Type: number Fixed penalty applied if the order was delivered with a violation of the soft transit time limit |
minute |
Type: number Penalty for each minute transit time violation |
global_proximity_attraction_point_rolling_throughput_kg_per_hour_0_item
Name |
Description |
time_window |
Type: string The time window during which the specified restriction applies. The windows must not intersect with each other, and their union must contain the defined working hours of the corresponding depot. If the restriction is not defined on any time interval outside depot working hours, then it is considered equal to zero. |
value |
Type: number Throughput, kilograms per hour. |
global_proximity_attraction_point_rolling_throughput_units_per_hour_0_item
Name |
Description |
time_window |
Type: string The time window during which the specified restriction applies. The windows must not intersect with each other, and their union must contain the defined working hours of the corresponding depot. If the restriction is not defined on any time interval outside depot working hours, then it is considered equal to zero. |
value |
Type: number Throughput, custom units per hour. |
global_proximity_attraction_point_rolling_throughput_vehicle_count_0_item
Name |
Description |
time_window |
Type: string The time window during which the specified restriction applies. The windows must not intersect with each other, and their union must contain the defined working hours of the corresponding depot. If the restriction is not defined on any time interval outside depot working hours, then it is considered equal to zero. |
value |
Type: number Throughput, simultaneously vehicles. Max value: |
global_proximity_attraction_point_shipment_size_volume
Shipment dimensions and type.
Name |
Description |
depth_m* |
Type: number Depth, meters. Max value: |
height_m* |
Type: number Height, meters. Max value: |
width_m* |
Type: number Width, meters. Max value: |
align |
Type: string Defines allowed container alignment for
Default: Enum: |
type |
Type: string Container type:
Default: Enum: |
global_proximity_attraction_point_throughput_kg_per_hour_0_item
Name |
Description |
time_window |
Type: string The time window during which the specified restriction applies. The windows must not intersect with each other, and their union must contain the defined working hours of the corresponding depot. If the restriction is not defined on any time interval outside depot working hours, then it is considered equal to zero. |
value |
Type: number Throughput, kilograms per hour. |
global_proximity_attraction_point_throughput_units_per_hour_0_item
Name |
Description |
time_window |
Type: string The time window during which the specified restriction applies. The windows must not intersect with each other, and their union must contain the defined working hours of the corresponding depot. If the restriction is not defined on any time interval outside depot working hours, then it is considered equal to zero. |
value |
Type: number Throughput, custom units per hour. |
global_proximity_attraction_point_throughput_vehicle_count_0_item
Name |
Description |
time_window |
Type: string The time window during which the specified restriction applies. The windows must not intersect with each other, and their union must contain the defined working hours of the corresponding depot. If the restriction is not defined on any time interval outside depot working hours, then it is considered equal to zero. |
value |
Type: number Throughput, simultaneously vehicles. Max value: |
shift_end_failed_time_window
Name |
Description |
duration_s* |
Type: number When a location is visited outside of the time window, indicates the duration (in seconds) between the reference time and the closest endpoint of the failed time window. The reference time is the start or the end of service depending on |
how* |
Type: string When a location is visited outside of the time window, indicates the time direction between the arrival time and the failed time window:
Enum: |
shift_end_overtime
Name |
Description |
duration_s* |
Type: number Vehicle shift overtime in seconds. |
shift_end_probably_failed_time_window
Name |
Description |
duration_s* |
Type: number Expected difference between arrival time and failing time window, seconds. |
how* |
Type: string When a location is visited outside of the time window, indicates the time direction between the arrival time and the failed time window:
Enum: |
probability* |
Type: number Probability of being outside of the time window, percent. |
high_risk |
Type: boolean When true, it means that probability of being late on location is greater or equal to |
end_violations_0_1
Name |
Description |
duration_s* |
Type: number Expected difference between arrival time and the deadline, seconds. |
pickup_id* |
Type: integer or string Defines |
type* |
Type: string Possible reasons:
Enum: |
end_violations_1_1
Name |
Description |
duration_s* |
Type: number Expected difference between arrival time and the deadline, seconds. |
high_risk* |
Type: boolean When true, it means that probability of being late on location is greater or equal to |
pickup_id* |
Type: integer or string Defines |
probability* |
Type: number Probability of being late, percent. |
type* |
Type: string Possible reasons:
Enum: |
shift_start_failed_time_window
Name |
Description |
duration_s* |
Type: number When a location is visited outside of the time window, indicates the duration (in seconds) between the reference time and the closest endpoint of the failed time window. The reference time is the start or the end of service depending on |
how* |
Type: string When a location is visited outside of the time window, indicates the time direction between the arrival time and the failed time window:
Enum: |
shift_start_overtime
Name |
Description |
duration_s* |
Type: number Vehicle shift overtime in seconds. |
shift_start_probably_failed_time_window
Name |
Description |
duration_s* |
Type: number Expected difference between arrival time and failing time window, seconds. |
how* |
Type: string When a location is visited outside of the time window, indicates the time direction between the arrival time and the failed time window:
Enum: |
probability* |
Type: number Probability of being outside of the time window, percent. |
high_risk |
Type: boolean When true, it means that probability of being late on location is greater or equal to |
start_violations_0_1
Name |
Description |
duration_s* |
Type: number Expected difference between arrival time and the deadline, seconds. |
pickup_id* |
Type: integer or string Defines |
type* |
Type: string Possible reasons:
Enum: |
start_violations_1_1
Name |
Description |
duration_s* |
Type: number Expected difference between arrival time and the deadline, seconds. |
high_risk* |
Type: boolean When true, it means that probability of being late on location is greater or equal to |
pickup_id* |
Type: integer or string Defines |
probability* |
Type: number Probability of being late, percent. |
type* |
Type: string Possible reasons:
Enum: |
shifts_penalty_early
Penalty components for shifts started too early (used instead of out_of_time
penalty). If the shift was also finished too early, it is applied to the shift finish too.
Name |
Description |
fixed |
Type: number Fixed penalty applied if the vehicle starts or finishes the shift before the start of the time window. Default: |
minute |
Type: number Penalty for each minute of earliness if the vehicle starts or finishes the shift before the start of the time window. Default: |
shifts_penalty_late
Penalty components for shifts finished too late (used instead of out_of_time
penalty). This penalty is applied for being late to the end of the shift's time window or violating the max_duration_s
bound. If both are violated simultaneously, the penalty is applied twice and summed. If the shift was started after the end of the time window, this penalty for the start time point is also added separately. More information
Name |
Description |
fixed |
Type: number Fixed penalty applied if the vehicle starts or finishes the shift after the end of the time window or shift duration exceeds the Default: |
minute |
Type: number Penalty for each minute of lateness if the vehicle starts or finishes the shift after the end of the time window or if the vehicle spends more than Default: |
shifts_penalty_max_mileage
Penalties applied for violating shift's max_mileage_km
limit.
Name |
Description |
fixed |
Type: number Fixed penalty applied if a vehicle shift has mileage greater than Default: |
km |
Type: number Penalty applied per each extra kilometer when shift mileage is greater than Default: |
shifts_penalty_out_of_time
Penalty components for time window failure. Can be used to set the values of early
and late
options simultaneously, and each value is overridden if the respective option is also defined.
Name |
Description |
fixed |
Type: number Fixed penalty applied if the vehicle starts or finishes the shift outside of the time window. See the specifications of Default: |
minute |
Type: number Penalty for each minute of being outside of the time window of the shift. See the specifications of Default: |
shifts_penalty_stop_excess
Penalties applied for violating shift's maximal_stops
limit.
Name |
Description |
fixed |
Type: number Fixed penalty applied if a vehicle shift has greater than |
per_stop |
Type: number Penalty applied per each extra stop when shift stop count is greater than |
shifts_penalty_stop_lack
Penalties applied for violating shift's minimal_stops
limit.
Name |
Description |
fixed |
Type: number Fixed penalty applied if a vehicle shift has less than |
per_stop |
Type: number Penalty applied per each missing stop when shift stop count is less than |
shifts_penalty_unique_stop_lack
Penalties applied for violating shift's minimal_stops
limit.
Name |
Description |
fixed |
Type: number Fixed penalty applied if a vehicle shift has less than |
per_stop |
Type: number Penalty applied per each missing stop when shift stop count is less than |
trailer_capacity_limits
Trailer load limits.
Name |
Description |
units_perc |
Type: number Upper limit of total shipments size in custom units as a percentage of a trailer capacity Default: |
volume_perc |
Type: number Upper limit of total shipments volume as a percentage of trailer volume. For container fitting purposes it is assumed that each dimension is multiplied by the cubic root of Default: |
weight_perc |
Type: number Upper limit of total shipments weight as a percentage of total weight the trailer is allowed to carry. Default: |
trailer_capacity_volume
Trailer dimensions.
Name |
Description |
depth_m* |
Type: number Depth, meters. Default: Max value: |
height_m* |
Type: number Height, meters. Default: Max value: |
width_m* |
Type: number Width, meters. Default: Max value: |
walking_courier_restrictions_max_parking_duration_s
Name |
Description |
penalty |
Type: number Penalty per second exceeding the maximum parking time. Max value: |
value |
Type: number The maximum duration of the walking part allowed within one parking, seconds. Default: Max value: |
walking_courier_restrictions_max_parking_walking_distance_m
Name |
Description |
penalty |
Type: number Penalty per m exceeding the maximum distance traveled within one parking. Max value: |
value |
Type: number The maximum walking distance allowed within one parking. Default: Max value: |
walking_courier_restrictions_max_walking_edge_distance_m
Name |
Description |
penalty |
Type: number Penalty for exceeding the walking edge limit per meter. Max value: |
value |
Type: number Max walking distance between two locations in route, meters. Default: Max value: |
raw_metrics_raw_metrics_item_14
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: raw_metrics_raw_metrics_item_13[] The value of an arbitrary cost. |
subcosts |
Type: raw_metrics_subcosts_item_13[] The value of an arbitrary cost. |
raw_metrics_subcosts_item_12
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: subcosts_raw_metrics_item_13[] The value of an arbitrary cost. |
subcosts |
Type: subcosts_subcosts_item_13[] The value of an arbitrary cost. |
subcosts_raw_metrics_item_11
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: raw_metrics_raw_metrics_item_10[] The value of an arbitrary cost. |
subcosts |
Type: raw_metrics_subcosts_item_9[] The value of an arbitrary cost. |
subcosts_subcosts_item_10
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: subcosts_raw_metrics_item_9[] The value of an arbitrary cost. |
subcosts |
Type: subcosts_subcosts_item_9[] The value of an arbitrary cost. |
raw_metrics_raw_metrics_item_7
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: raw_metrics_raw_metrics_item_6[] The value of an arbitrary cost. |
subcosts |
Type: raw_metrics_subcosts_item_6[] The value of an arbitrary cost. |
raw_metrics_subcosts_item_5
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: subcosts_raw_metrics_item_6[] The value of an arbitrary cost. |
subcosts |
Type: subcosts_subcosts_item_6[] The value of an arbitrary cost. |
subcosts_raw_metrics_item_4
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: raw_metrics_raw_metrics_item_3[] The value of an arbitrary cost. |
subcosts |
Type: raw_metrics_subcosts_item_2[] The value of an arbitrary cost. |
subcosts_subcosts_item_3
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: subcosts_raw_metrics_item_2[] The value of an arbitrary cost. |
subcosts |
Type: subcosts_subcosts_item_2[] The value of an arbitrary cost. |
penalty_early
Penalty components for early work break.
Name |
Description |
fixed |
Type: number Fixed penalty applied if a worker starts a work break while they worked for a less than the specified minimal work duration since the start of work or the previous work break ending. Default: |
minute |
Type: number Penalty for each minute of an early start of work break if a worker starts a work break while they worked for a less than the specified minimal work duration since the start of work or the previous work break ending. Default: |
penalty_late
Penalty components for late work break.
Name |
Description |
fixed |
Type: number Fixed penalty applied if a worker starts a work break while they worked for a more than the specified maximal work duration since the start of work or the previous work break ending. Default: |
minute |
Type: number Penalty for each minute of a late start of work break if a worker starts a work break while they worked for a more than the specified maximal work duration since the start of work or the previous work break ending. Default: |
route_depot_location_package_throughput
Restriction on packaging speed in depot.
Name |
Description |
kg_per_hour |
Type: array or number |
units_per_hour |
Type: array or number |
route_depot_location_penalty
Penalties for depot time window or throughput failure. More information
Name |
Description |
early |
Type: route_depot_location_penalty_early Penalty components for early service (used instead of |
late |
Type: route_depot_location_penalty_late Penalty components for late visits (used instead of |
out_of_time |
Type: route_depot_location_penalty_out_of_time Penalty components for time window failure. Can be used to set the values of |
package_throughput |
Type: route_depot_location_penalty_package_throughput Penalty components for package throughput exceeding. |
throughput |
Type: route_depot_location_penalty_throughput Penalty components for throughput exceeding. |
route_depot_location_throughput
Depot throughput limit. More information
Name |
Description |
kg_per_hour |
Type: array or number |
units_per_hour |
Type: array or number |
vehicle_count |
Type: array or number |
route_depot_location_time_windows_item
Name |
Description |
time_window* |
Type: string Allowed time window to visit location, in |
hard_time_window |
Type: string Allowed hard time window to visit location, in |
route_depot_location_time_windows_loading
Time windows when the vehicle is allowed to leave the depot on the 1st run
Name |
Description |
hard_time_window |
Type: string Allowed hard time window to visit location, in |
hard_window |
Type: boolean Time window, specified in the "time_window" field, should be hard, incompatible with the "hard_time_window" field. |
penalty |
|
time_window |
Type: string Allowed time window to visit location, in |
time_windows |
Type: route_depot_location_time_windows_loading_time_windows_item[] List of allowed time windows. Time windows can not overlap. Fields |
route_depot_location_time_windows_refilling
Time windows when the vehicle is allowed to visit a depot (or middle depot) for additional loading
Name |
Description |
hard_time_window |
Type: string Allowed hard time window to visit location, in |
hard_window |
Type: boolean Time window, specified in the "time_window" field, should be hard, incompatible with the "hard_time_window" field. |
penalty |
|
time_window |
Type: string Allowed time window to visit location, in |
time_windows |
Type: route_depot_location_time_windows_refilling_time_windows_item[] List of allowed time windows. Time windows can not overlap. Fields |
route_depot_location_time_windows_unloading
Time windows when the vehicle is allowed to return to the depot on the last run
Name |
Description |
hard_time_window |
Type: string Allowed hard time window to visit location, in |
hard_window |
Type: boolean Time window, specified in the "time_window" field, should be hard, incompatible with the "hard_time_window" field. |
penalty |
|
time_window |
Type: string Allowed time window to visit location, in |
time_windows |
Type: route_depot_location_time_windows_unloading_time_windows_item[] List of allowed time windows. Time windows can not overlap. Fields |
route_depot_location_unfeasible_reasons_0
The reason why the location is not feasible.
Name |
Description |
late_duration_s* |
Type: number The duration of late arrival, (arrival time) - (end of time window), seconds. |
text* |
Type: string Explanation for the reason the location was not feasible. |
type* |
Type: string Possible reasons:
Enum: |
route_depot_location_unfeasible_reasons_1
The reason why the location is not feasible.
Name |
Description |
overrun_s* |
Type: number The amount of time by which the hard transit time restriction was exceeded, in seconds |
text* |
Type: string Explanation for the reason the location was not feasible. |
type* |
Type: string Possible reasons:
Enum: |
route_depot_location_unfeasible_reasons_2
The reason why the location is not feasible.
Name |
Description |
text* |
Type: string Explanation for the reason the location was not feasible. |
type* |
Type: string Possible reasons:
Enum: |
route_location_1_optional_tags_item
An optional tag with bonus or penalty.
Name |
Description |
tag* |
Type: string An arbitrary tag. |
value* |
Type: number Value of the tag. When location is served by a vehicle with a matching tag in |
route_location_1_penalty
Penalties for non-completion and time window failure. More information
Name |
Description |
delivery_deadline |
Type: route_location_1_penalty_delivery_deadline Penalty components for late deliveries from |
depot_expiring_time |
Type: route_location_1_penalty_depot_expiring_time Penalty components for violation |
depot_ready_time |
Type: route_location_1_penalty_depot_ready_time Penalty components for violation |
drop |
Type: route_location_1_penalty_drop_0 or number Penalty for not delivering an order. More information |
early |
Type: route_location_1_penalty_early Penalty components for early service (used instead of |
late |
Type: route_location_1_penalty_late Penalty components for late visits (used instead of |
out_of_time |
Type: route_location_1_penalty_out_of_time Penalty components for time window failure. Can be used to set the values of |
rolling_throughput |
Type: route_location_1_penalty_rolling_throughput Penalty components for throughput exceeding. |
throughput |
Type: route_location_1_penalty_throughput Penalty components for throughput exceeding. |
time_between_visits |
Type: route_location_1_penalty_time_between_visits Penalty components for exceeding |
transit_time |
Type: route_location_1_penalty_transit_time Penalty components for exceeding transit time |
route_location_1_quant_0
Minimal part which can be split from the order measured in one of the units
Name |
Description |
units |
Type: number Size of shipment in custom units. |
volume_cbm |
Type: number Volume of minimal part, cubic meters. |
weight_kg |
Type: number Weight of minimal part, kilograms. |
route_location_1_rolling_throughput
Rolling throughput limit (supported for anchors).
Name |
Description |
kg_per_hour |
Type: array or number |
units_per_hour |
Type: array or number |
vehicle_count |
Type: array or number |
route_location_1_shipment_size
Shipment size (dimensions and/or weight). More information
Name |
Description |
custom |
Type: number Size of shipment in custom units. Sizes in custom units are defined in format |
units |
Type: number Size of shipment in custom units. Max value: |
volume |
Type: route_location_1_shipment_size_volume Shipment dimensions and type. |
volume_cbm |
Type: number Explicit volume, cubic meters. By default, the value is taken from "volume", if nothing is specified here. |
weight_kg |
Type: number Weight of shipment, kilograms. Max value: |
route_location_1_split_info
Information about split part of the order (in case if the order was split)
Name |
Description |
order_ratio |
Type: number Order ratio, included in this part. |
part_id |
Type: integer Number of this part of the order. |
parts_count |
Type: integer Number of parts, in which the order was split. |
units |
Type: number Size of this part in custom units (in case there was corresponding quant specified for this order). |
volume_cbm |
Type: number Volume of this part, cubic meters (in case there was corresponding quant specified for this order). |
weight_kg |
Type: number Weight of this part, kilograms (in case there was corresponding quant specified for this order). |
route_location_1_throughput
Location throughput limit (supported for the orders which can be split).
Name |
Description |
kg_per_hour |
Type: array or number |
units_per_hour |
Type: array or number |
vehicle_count |
Type: array or number |
route_location_1_time_windows_item
Name |
Description |
time_window* |
Type: string Allowed time window to visit location, in |
hard_time_window |
Type: string Allowed hard time window to visit location, in |
route_location_1_transit_time
Restrictions on the time the order spends inside a vehicle
Name |
Description |
hard_limit_s |
Type: number Hard time limit, values above it are unacceptable Max value: |
limit_s |
Type: number Soft time limit, values above it are acceptable but they will be penalized Max value: |
route_location_1_unfeasible_reasons_0
The reason why the location is not feasible.
Name |
Description |
overload* |
Type: number The overload value. The unit used depends on the overload type:
|
text* |
Type: string Explanation for the reason the location was not feasible. |
type* |
Type: string Possible reasons:
Enum: |
custom_type |
Type: string Type of custom units that caused overload in case of OVERLOAD_CUSTOM. |
route_location_1_unfeasible_reasons_1
The reason why the location is not feasible.
Name |
Description |
late_duration_s* |
Type: number The duration of late arrival, (arrival time) - (end of time window), seconds. |
text* |
Type: string Explanation for the reason the location was not feasible. |
type* |
Type: string Possible reasons:
Enum: |
route_location_1_unfeasible_reasons_2
The reason why the location is not feasible.
Name |
Description |
tags* |
Type: string[] List of missing required tags. |
text* |
Type: string Explanation for the reason the location was not feasible. |
type* |
Type: string Possible reasons:
Enum: |
route_location_1_unfeasible_reasons_3
The reason why the location is not feasible.
Name |
Description |
tags* |
Type: string[] List of present excluded tags. |
text* |
Type: string Explanation for the reason the location was not feasible. |
type* |
Type: string Possible reasons:
Enum: |
route_location_1_unfeasible_reasons_4
The reason why the location is not feasible.
Name |
Description |
overrun_s* |
Type: number The amount of time by which the hard transit time restriction was exceeded, in seconds |
text* |
Type: string Explanation for the reason the location was not feasible. |
type* |
Type: string Possible reasons:
Enum: |
route_location_1_unfeasible_reasons_5
The reason why the location is not feasible.
Name |
Description |
incompatibilities* |
Type: unfeasible_reasons_incompatibilities_item_2[] List of all incompatibile load type pairs |
text* |
Type: string Explanation for the reason the location was not feasible. |
type* |
Type: string Possible reasons:
Enum: |
route_location_1_unfeasible_reasons_6
The reason why the location is not feasible.
Name |
Description |
incompatibilities* |
Type: unfeasible_reasons_incompatibilities_item[] List of all incompatibile zone pairs |
text* |
Type: string Explanation for the reason the location was not feasible. |
type* |
Type: string Possible reasons:
Enum: |
route_location_1_unfeasible_reasons_7
The reason why the location is not feasible.
Name |
Description |
tags* |
Type: string[] List of vehicle's allowed zones. |
text* |
Type: string Explanation for the reason the location was not feasible. |
type* |
Type: string Possible reasons:
Enum: |
route_location_1_unfeasible_reasons_8
The reason why the location is not feasible.
Name |
Description |
tags* |
Type: string[] List of present forbidden zones. |
text* |
Type: string Explanation for the reason the location was not feasible. |
type* |
Type: string Possible reasons:
Enum: |
route_location_1_unfeasible_reasons_9
The reason why the location is not feasible.
Name |
Description |
text* |
Type: string Explanation for the reason the location was not feasible. |
type* |
Type: string Possible reasons:
Enum: |
route_work_break_penalty
Penalties applied for violations of work break conditions.
Name |
Description |
early |
Type: route_work_break_penalty_early Penalty components for early work break. |
late |
Type: route_work_break_penalty_late Penalty components for late work break. |
raw_metrics_raw_metrics_item_13
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: raw_metrics_raw_metrics_item_12[] The value of an arbitrary cost. |
subcosts |
Type: raw_metrics_subcosts_item_14[] The value of an arbitrary cost. |
raw_metrics_subcosts_item_13
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: subcosts_raw_metrics_item_14[] The value of an arbitrary cost. |
subcosts |
Type: subcosts_subcosts_item_14[] The value of an arbitrary cost. |
subcosts_raw_metrics_item_13
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: raw_metrics_raw_metrics_item_11[] The value of an arbitrary cost. |
subcosts |
Type: raw_metrics_subcosts_item_11[] The value of an arbitrary cost. |
subcosts_subcosts_item_13
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: subcosts_raw_metrics_item_12[] The value of an arbitrary cost. |
subcosts |
Type: subcosts_subcosts_item_12[] The value of an arbitrary cost. |
raw_metrics_raw_metrics_item_10
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: raw_metrics_raw_metrics_item_9[] The value of an arbitrary cost. |
subcosts |
Type: raw_metrics_subcosts_item_10[] The value of an arbitrary cost. |
raw_metrics_subcosts_item_9
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: subcosts_raw_metrics_item_10[] The value of an arbitrary cost. |
subcosts |
Type: subcosts_subcosts_item_11[] The value of an arbitrary cost. |
subcosts_raw_metrics_item_9
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: raw_metrics_raw_metrics_item_8[] The value of an arbitrary cost. |
subcosts |
Type: raw_metrics_subcosts_item_8[] The value of an arbitrary cost. |
subcosts_subcosts_item_9
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: subcosts_raw_metrics_item_8[] The value of an arbitrary cost. |
subcosts |
Type: subcosts_subcosts_item_8[] The value of an arbitrary cost. |
raw_metrics_raw_metrics_item_6
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: raw_metrics_raw_metrics_item_5[] The value of an arbitrary cost. |
subcosts |
Type: raw_metrics_subcosts_item_7[] The value of an arbitrary cost. |
raw_metrics_subcosts_item_6
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: subcosts_raw_metrics_item_7[] The value of an arbitrary cost. |
subcosts |
Type: subcosts_subcosts_item_7[] The value of an arbitrary cost. |
subcosts_raw_metrics_item_6
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: raw_metrics_raw_metrics_item_4[] The value of an arbitrary cost. |
subcosts |
Type: raw_metrics_subcosts_item_4[] The value of an arbitrary cost. |
subcosts_subcosts_item_6
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: subcosts_raw_metrics_item_5[] The value of an arbitrary cost. |
subcosts |
Type: subcosts_subcosts_item_5[] The value of an arbitrary cost. |
raw_metrics_raw_metrics_item_3
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: raw_metrics_raw_metrics_item_2[] The value of an arbitrary cost. |
subcosts |
Type: raw_metrics_subcosts_item_3[] The value of an arbitrary cost. |
raw_metrics_subcosts_item_2
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: subcosts_raw_metrics_item_3[] The value of an arbitrary cost. |
subcosts |
Type: subcosts_subcosts_item_4[] The value of an arbitrary cost. |
subcosts_raw_metrics_item_2
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: raw_metrics_raw_metrics_item_1[] The value of an arbitrary cost. |
subcosts |
Type: raw_metrics_subcosts_item_1[] The value of an arbitrary cost. |
subcosts_subcosts_item_2
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: subcosts_raw_metrics_item_1[] The value of an arbitrary cost. |
subcosts |
Type: subcosts_subcosts_item_1[] The value of an arbitrary cost. |
route_depot_location_package_throughput_kg_per_hour_0_item
Name |
Description |
time_window |
Type: string The time window during which the specified restriction applies. The windows must not intersect with each other, and their union must contain the defined working hours of the corresponding depot. If the restriction is not defined on any time interval outside depot working hours, then it is considered equal to zero. |
value |
Type: number Depot package throughput, kilograms per hour. |
route_depot_location_package_throughput_units_per_hour_0_item
Name |
Description |
time_window |
Type: string The time window during which the specified restriction applies. The windows must not intersect with each other, and their union must contain the defined working hours of the corresponding depot. If the restriction is not defined on any time interval outside depot working hours, then it is considered equal to zero. |
value |
Type: number Depot package throughput, units per hour. |
route_depot_location_penalty_early
Penalty components for early service (used instead of out_of_time
penalty).
Name |
Description |
fixed |
Type: number Fixed penalty applied if a vehicle starts serving the depot before the start of the time window. The penalty is applied for any early service, including opening the depot, unloading or uploading the vehicle at the depot or closing the depot. It is applied once for each visit of a depot during which the depot was served early. Default: |
minute |
Type: number Penalty for each minute of early service of the depot. Applied in the same cases as the Default: |
route_depot_location_penalty_late
Penalty components for late visits (used instead of out_of_time
penalty). Whether the start or the end of service during the visit is used to penalize for lateness is determined by the penalize_late_service
option.
Name |
Description |
fixed |
Type: number Fixed penalty applied for each visit of the depot after the end of the time window. Starting from a depot is counted for a visit. Default: |
minute |
Type: number Penalty for each minute of lateness for every visit of the depot after the end of the time window. Default: |
route_depot_location_penalty_out_of_time
Penalty components for time window failure. Can be used to set the values of early
and late
options simultaneously, and each value is overridden if the respective option is also defined.
Name |
Description |
fixed |
Type: number Fixed penalty applied if the depot is visited outside of the time window. See the specifications of Default: |
minute |
Type: number Penalty for each minute of being outside of the time window of the depot. See the specifications of Default: |
route_depot_location_penalty_package_throughput
Penalty components for package throughput exceeding.
Name |
Description |
fixed |
Type: number Fixed penalty applied if throughput is exceeded. Default: |
kg |
Type: number Penalty for each extra kg of throughput exceeding. Default: |
unit |
Type: number Penalty for each extra custom unit of throughput exceeding ( Default: |
route_depot_location_penalty_throughput
Penalty components for throughput exceeding.
Name |
Description |
fixed |
Type: number Fixed penalty applied if throughput is exceeded. Default: |
kg |
Type: number Penalty for each extra kg of throughput exceeding. Default: |
unit |
Type: number Penalty for each extra custom unit of throughput exceeding ( Default: |
vehicle |
Type: number Penalty for each extra vehicle per hour of throughput exceeding. Default: |
route_depot_location_throughput_kg_per_hour_0_item
Name |
Description |
time_window |
Type: string The time window during which the specified restriction applies. The windows must not intersect with each other, and their union must contain the defined working hours of the corresponding depot. If the restriction is not defined on any time interval outside depot working hours, then it is considered equal to zero. |
value |
Type: number Throughput, kilograms per hour. |
route_depot_location_throughput_units_per_hour_0_item
Name |
Description |
time_window |
Type: string The time window during which the specified restriction applies. The windows must not intersect with each other, and their union must contain the defined working hours of the corresponding depot. If the restriction is not defined on any time interval outside depot working hours, then it is considered equal to zero. |
value |
Type: number Throughput, custom units per hour. |
route_depot_location_throughput_vehicle_count_0_item
Name |
Description |
time_window |
Type: string The time window during which the specified restriction applies. The windows must not intersect with each other, and their union must contain the defined working hours of the corresponding depot. If the restriction is not defined on any time interval outside depot working hours, then it is considered equal to zero. |
value |
Type: number Throughput, simultaneously vehicles. Max value: |
route_depot_location_time_windows_loading_penalty
Name |
Description |
early |
Type: time_windows_loading_penalty_early Penalty components for early service (used instead of |
late |
Type: time_windows_loading_penalty_late Penalty components for late visits (used instead of |
out_of_time |
Type: time_windows_loading_penalty_out_of_time Penalty components for time window failure. Can be used to set the values of |
route_depot_location_time_windows_loading_time_windows_item
Name |
Description |
time_window* |
Type: string Allowed time window to visit location, in |
hard_time_window |
Type: string Allowed hard time window to visit location, in |
route_depot_location_time_windows_refilling_penalty
Name |
Description |
early |
Type: time_windows_refilling_penalty_early Penalty components for early service (used instead of |
late |
Type: time_windows_refilling_penalty_late Penalty components for late visits (used instead of |
out_of_time |
Type: time_windows_refilling_penalty_out_of_time Penalty components for time window failure. Can be used to set the values of |
route_depot_location_time_windows_refilling_time_windows_item
Name |
Description |
time_window* |
Type: string Allowed time window to visit location, in |
hard_time_window |
Type: string Allowed hard time window to visit location, in |
route_depot_location_time_windows_unloading_penalty
Name |
Description |
early |
Type: time_windows_unloading_penalty_early Penalty components for early service (used instead of |
late |
Type: time_windows_unloading_penalty_late Penalty components for late visits (used instead of |
out_of_time |
Type: time_windows_unloading_penalty_out_of_time Penalty components for time window failure. Can be used to set the values of |
route_depot_location_time_windows_unloading_time_windows_item
Name |
Description |
time_window* |
Type: string Allowed time window to visit location, in |
hard_time_window |
Type: string Allowed hard time window to visit location, in |
route_location_1_penalty_delivery_deadline
Penalty components for late deliveries from pickup
locations to depots. Whether the start or the end of service during the visit is used to penalize for lateness is determined by the penalize_late_service
option. More information
Name |
Description |
fixed |
Type: number Fixed penalty applied if the depot is visited after the deadline. Default: |
minute |
Type: number Penalty for each minute of lateness, when the depot is visited after the deadline. Default: |
route_location_1_penalty_depot_expiring_time
Penalty components for violation soft_depot_expiring_time
restriction.
Name |
Description |
fixed |
Type: number Penalty for violation, regardless of the size of the violation. Default: |
minute |
Type: number Penalty for every minute of violation. Default: |
route_location_1_penalty_depot_ready_time
Penalty components for violation soft_depot_ready_time
restriction.
Name |
Description |
fixed |
Type: number Penalty for violation, regardless of the size of the violation. Default: |
minute |
Type: number Penalty for every minute of violation. Default: |
route_location_1_penalty_drop_0
Name |
Description |
fixed |
Type: number Fixed penalty for not delivering any part of the order. |
scaled |
Type: number Penalty for not delivering order ratio. Default: |
route_location_1_penalty_early
Penalty components for early service (used instead of out_of_time
penalty).
Name |
Description |
fixed |
Type: number Fixed penalty applied if the location starts being served before the start of the time window. Default: |
minute |
Type: number Penalty for each minute of early arrival when the location starts being served before the start of the time window. Default: |
route_location_1_penalty_late
Penalty components for late visits (used instead of out_of_time
penalty). Whether the start or the end of service during the visit is used to penalize for lateness is determined by the penalize_late_service
option.
Name |
Description |
fixed |
Type: number Fixed penalty applied if the location is visited after the end of the time window. Default: |
minute |
Type: number Penalty for each minute of lateness, when the location is visited after the end of the time window. Default: |
route_location_1_penalty_out_of_time
Penalty components for time window failure. Can be used to set the values of early
and late
options simultaneously, and each value is overridden if the respective option is also defined.
Name |
Description |
fixed |
Type: number Fixed penalty applied if the location is visited outside of the time window. See the specifications of Default: |
minute |
Type: number Penalty for each minute of lateness or early arrival when the location is visited outside of the time window. See the specifications of Default: |
route_location_1_penalty_rolling_throughput
Penalty components for throughput exceeding.
Name |
Description |
fixed |
Type: number Fixed penalty applied if throughput is exceeded. Default: |
kg |
Type: number Penalty for each extra kg of throughput exceeding. Default: |
unit |
Type: number Penalty for each extra custom unit of throughput exceeding ( Default: |
vehicle |
Type: number Penalty for each extra vehicle per hour of throughput exceeding. Default: |
route_location_1_penalty_throughput
Penalty components for throughput exceeding.
Name |
Description |
fixed |
Type: number Fixed penalty applied if throughput is exceeded. Default: |
kg |
Type: number Penalty for each extra kg of throughput exceeding. Default: |
unit |
Type: number Penalty for each extra custom unit of throughput exceeding ( Default: |
vehicle |
Type: number Penalty for each extra vehicle per hour of throughput exceeding. Default: |
route_location_1_penalty_time_between_visits
Penalty components for exceeding max_time_between_visits_s
restriction.
Name |
Description |
fixed |
Type: number Penalty for each case of violation, regardless of the size of the violation. Default: |
minute |
Type: number Penalty for every minute of violation. Default: |
route_location_1_penalty_transit_time
Penalty components for exceeding transit time
Name |
Description |
fixed |
Type: number Fixed penalty applied if the order was delivered with a violation of the soft transit time limit |
minute |
Type: number Penalty for each minute transit time violation |
route_location_1_rolling_throughput_kg_per_hour_0_item
Name |
Description |
time_window |
Type: string The time window during which the specified restriction applies. The windows must not intersect with each other, and their union must contain the defined working hours of the corresponding depot. If the restriction is not defined on any time interval outside depot working hours, then it is considered equal to zero. |
value |
Type: number Throughput, kilograms per hour. |
route_location_1_rolling_throughput_units_per_hour_0_item
Name |
Description |
time_window |
Type: string The time window during which the specified restriction applies. The windows must not intersect with each other, and their union must contain the defined working hours of the corresponding depot. If the restriction is not defined on any time interval outside depot working hours, then it is considered equal to zero. |
value |
Type: number Throughput, custom units per hour. |
route_location_1_rolling_throughput_vehicle_count_0_item
Name |
Description |
time_window |
Type: string The time window during which the specified restriction applies. The windows must not intersect with each other, and their union must contain the defined working hours of the corresponding depot. If the restriction is not defined on any time interval outside depot working hours, then it is considered equal to zero. |
value |
Type: number Throughput, simultaneously vehicles. Max value: |
route_location_1_shipment_size_volume
Shipment dimensions and type.
Name |
Description |
depth_m* |
Type: number Depth, meters. Max value: |
height_m* |
Type: number Height, meters. Max value: |
width_m* |
Type: number Width, meters. Max value: |
align |
Type: string Defines allowed container alignment for
Default: Enum: |
type |
Type: string Container type:
Default: Enum: |
route_location_1_throughput_kg_per_hour_0_item
Name |
Description |
time_window |
Type: string The time window during which the specified restriction applies. The windows must not intersect with each other, and their union must contain the defined working hours of the corresponding depot. If the restriction is not defined on any time interval outside depot working hours, then it is considered equal to zero. |
value |
Type: number Throughput, kilograms per hour. |
route_location_1_throughput_units_per_hour_0_item
Name |
Description |
time_window |
Type: string The time window during which the specified restriction applies. The windows must not intersect with each other, and their union must contain the defined working hours of the corresponding depot. If the restriction is not defined on any time interval outside depot working hours, then it is considered equal to zero. |
value |
Type: number Throughput, custom units per hour. |
route_location_1_throughput_vehicle_count_0_item
Name |
Description |
time_window |
Type: string The time window during which the specified restriction applies. The windows must not intersect with each other, and their union must contain the defined working hours of the corresponding depot. If the restriction is not defined on any time interval outside depot working hours, then it is considered equal to zero. |
value |
Type: number Throughput, simultaneously vehicles. Max value: |
unfeasible_reasons_incompatibilities_item_2
A list of all pairs of load types that are not compatible with an order.
Name |
Description |
incompatible_order_id* |
Type: integer or string Reference to a location specified in |
types* |
Type: incompatibilities_types_item[] |
unfeasible_reasons_incompatibilities_item
A list of all pairs of zones that are not compatible with an order.
Name |
Description |
incompatible_order_id* |
Type: integer or string Reference to a location specified in |
zones* |
Type: incompatibilities_zones_item[] |
route_work_break_penalty_early
Penalty components for early work break.
Name |
Description |
fixed |
Type: number Fixed penalty applied if a worker starts a work break while they worked for a less than the specified minimal work duration since the start of work or the previous work break ending. Default: |
minute |
Type: number Penalty for each minute of an early start of work break if a worker starts a work break while they worked for a less than the specified minimal work duration since the start of work or the previous work break ending. Default: |
route_work_break_penalty_late
Penalty components for late work break.
Name |
Description |
fixed |
Type: number Fixed penalty applied if a worker starts a work break while they worked for a more than the specified maximal work duration since the start of work or the previous work break ending. Default: |
minute |
Type: number Penalty for each minute of a late start of work break if a worker starts a work break while they worked for a more than the specified maximal work duration since the start of work or the previous work break ending. Default: |
raw_metrics_raw_metrics_item_12
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: raw_metrics_raw_metrics_item[] The value of an arbitrary cost. |
subcosts |
Type: raw_metrics_subcosts_item[] The value of an arbitrary cost. |
raw_metrics_subcosts_item_14
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: subcosts_raw_metrics_item[] The value of an arbitrary cost. |
subcosts |
Type: subcosts_subcosts_item[] The value of an arbitrary cost. |
subcosts_raw_metrics_item_14
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: raw_metrics_raw_metrics_item[] The value of an arbitrary cost. |
subcosts |
Type: raw_metrics_subcosts_item[] The value of an arbitrary cost. |
subcosts_subcosts_item_14
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: subcosts_raw_metrics_item[] The value of an arbitrary cost. |
subcosts |
Type: subcosts_subcosts_item[] The value of an arbitrary cost. |
raw_metrics_raw_metrics_item_11
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: raw_metrics_raw_metrics_item[] The value of an arbitrary cost. |
subcosts |
Type: raw_metrics_subcosts_item[] The value of an arbitrary cost. |
raw_metrics_subcosts_item_11
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: subcosts_raw_metrics_item[] The value of an arbitrary cost. |
subcosts |
Type: subcosts_subcosts_item[] The value of an arbitrary cost. |
subcosts_raw_metrics_item_12
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: raw_metrics_raw_metrics_item[] The value of an arbitrary cost. |
subcosts |
Type: raw_metrics_subcosts_item[] The value of an arbitrary cost. |
subcosts_subcosts_item_12
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: subcosts_raw_metrics_item[] The value of an arbitrary cost. |
subcosts |
Type: subcosts_subcosts_item[] The value of an arbitrary cost. |
raw_metrics_raw_metrics_item_9
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: raw_metrics_raw_metrics_item[] The value of an arbitrary cost. |
subcosts |
Type: raw_metrics_subcosts_item[] The value of an arbitrary cost. |
raw_metrics_subcosts_item_10
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: subcosts_raw_metrics_item[] The value of an arbitrary cost. |
subcosts |
Type: subcosts_subcosts_item[] The value of an arbitrary cost. |
subcosts_raw_metrics_item_10
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: raw_metrics_raw_metrics_item[] The value of an arbitrary cost. |
subcosts |
Type: raw_metrics_subcosts_item[] The value of an arbitrary cost. |
subcosts_subcosts_item_11
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: subcosts_raw_metrics_item[] The value of an arbitrary cost. |
subcosts |
Type: subcosts_subcosts_item[] The value of an arbitrary cost. |
raw_metrics_raw_metrics_item_8
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: raw_metrics_raw_metrics_item[] The value of an arbitrary cost. |
subcosts |
Type: raw_metrics_subcosts_item[] The value of an arbitrary cost. |
raw_metrics_subcosts_item_8
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: subcosts_raw_metrics_item[] The value of an arbitrary cost. |
subcosts |
Type: subcosts_subcosts_item[] The value of an arbitrary cost. |
subcosts_raw_metrics_item_8
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: raw_metrics_raw_metrics_item[] The value of an arbitrary cost. |
subcosts |
Type: raw_metrics_subcosts_item[] The value of an arbitrary cost. |
subcosts_subcosts_item_8
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: subcosts_raw_metrics_item[] The value of an arbitrary cost. |
subcosts |
Type: subcosts_subcosts_item[] The value of an arbitrary cost. |
raw_metrics_raw_metrics_item_5
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: raw_metrics_raw_metrics_item[] The value of an arbitrary cost. |
subcosts |
Type: raw_metrics_subcosts_item[] The value of an arbitrary cost. |
raw_metrics_subcosts_item_7
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: subcosts_raw_metrics_item[] The value of an arbitrary cost. |
subcosts |
Type: subcosts_subcosts_item[] The value of an arbitrary cost. |
subcosts_raw_metrics_item_7
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: raw_metrics_raw_metrics_item[] The value of an arbitrary cost. |
subcosts |
Type: raw_metrics_subcosts_item[] The value of an arbitrary cost. |
subcosts_subcosts_item_7
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: subcosts_raw_metrics_item[] The value of an arbitrary cost. |
subcosts |
Type: subcosts_subcosts_item[] The value of an arbitrary cost. |
raw_metrics_raw_metrics_item_4
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: raw_metrics_raw_metrics_item[] The value of an arbitrary cost. |
subcosts |
Type: raw_metrics_subcosts_item[] The value of an arbitrary cost. |
raw_metrics_subcosts_item_4
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: subcosts_raw_metrics_item[] The value of an arbitrary cost. |
subcosts |
Type: subcosts_subcosts_item[] The value of an arbitrary cost. |
subcosts_raw_metrics_item_5
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: raw_metrics_raw_metrics_item[] The value of an arbitrary cost. |
subcosts |
Type: raw_metrics_subcosts_item[] The value of an arbitrary cost. |
subcosts_subcosts_item_5
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: subcosts_raw_metrics_item[] The value of an arbitrary cost. |
subcosts |
Type: subcosts_subcosts_item[] The value of an arbitrary cost. |
raw_metrics_raw_metrics_item_2
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: raw_metrics_raw_metrics_item[] The value of an arbitrary cost. |
subcosts |
Type: raw_metrics_subcosts_item[] The value of an arbitrary cost. |
raw_metrics_subcosts_item_3
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: subcosts_raw_metrics_item[] The value of an arbitrary cost. |
subcosts |
Type: subcosts_subcosts_item[] The value of an arbitrary cost. |
subcosts_raw_metrics_item_3
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: raw_metrics_raw_metrics_item[] The value of an arbitrary cost. |
subcosts |
Type: raw_metrics_subcosts_item[] The value of an arbitrary cost. |
subcosts_subcosts_item_4
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: subcosts_raw_metrics_item[] The value of an arbitrary cost. |
subcosts |
Type: subcosts_subcosts_item[] The value of an arbitrary cost. |
raw_metrics_raw_metrics_item_1
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: raw_metrics_raw_metrics_item[] The value of an arbitrary cost. |
subcosts |
Type: raw_metrics_subcosts_item[] The value of an arbitrary cost. |
raw_metrics_subcosts_item_1
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: subcosts_raw_metrics_item[] The value of an arbitrary cost. |
subcosts |
Type: subcosts_subcosts_item[] The value of an arbitrary cost. |
subcosts_raw_metrics_item_1
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: raw_metrics_raw_metrics_item[] The value of an arbitrary cost. |
subcosts |
Type: raw_metrics_subcosts_item[] The value of an arbitrary cost. |
subcosts_subcosts_item_1
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics |
Type: subcosts_raw_metrics_item[] The value of an arbitrary cost. |
subcosts |
Type: subcosts_subcosts_item[] The value of an arbitrary cost. |
time_windows_loading_penalty_early
Penalty components for early service (used instead of out_of_time
penalty).
Name |
Description |
fixed |
Type: number Fixed penalty applied if the location starts being served before the start of the time window. Default: |
minute |
Type: number Penalty for each minute of early arrival when the location starts being served before the start of the time window. Default: |
time_windows_loading_penalty_late
Penalty components for late visits (used instead of out_of_time
penalty). Whether the start or the end of service during the visit is used to penalize for lateness is determined by the penalize_late_service
option.
Name |
Description |
fixed |
Type: number Fixed penalty applied if the location is visited after the end of the time window. Default: |
minute |
Type: number Penalty for each minute of lateness, when the location is visited after the end of the time window. Default: |
time_windows_loading_penalty_out_of_time
Penalty components for time window failure. Can be used to set the values of early
and late
options simultaneously, and each value is overridden if the respective option is also defined.
Name |
Description |
fixed |
Type: number Fixed penalty applied if the location is visited outside of the time window. See the specifications of Default: |
minute |
Type: number Penalty for each minute of lateness or early arrival when the location is visited outside of the time window. See the specifications of Default: |
time_windows_refilling_penalty_early
Penalty components for early service (used instead of out_of_time
penalty).
Name |
Description |
fixed |
Type: number Fixed penalty applied if the location starts being served before the start of the time window. Default: |
minute |
Type: number Penalty for each minute of early arrival when the location starts being served before the start of the time window. Default: |
time_windows_refilling_penalty_late
Penalty components for late visits (used instead of out_of_time
penalty). Whether the start or the end of service during the visit is used to penalize for lateness is determined by the penalize_late_service
option.
Name |
Description |
fixed |
Type: number Fixed penalty applied if the location is visited after the end of the time window. Default: |
minute |
Type: number Penalty for each minute of lateness, when the location is visited after the end of the time window. Default: |
time_windows_refilling_penalty_out_of_time
Penalty components for time window failure. Can be used to set the values of early
and late
options simultaneously, and each value is overridden if the respective option is also defined.
Name |
Description |
fixed |
Type: number Fixed penalty applied if the location is visited outside of the time window. See the specifications of Default: |
minute |
Type: number Penalty for each minute of lateness or early arrival when the location is visited outside of the time window. See the specifications of Default: |
time_windows_unloading_penalty_early
Penalty components for early service (used instead of out_of_time
penalty).
Name |
Description |
fixed |
Type: number Fixed penalty applied if the location starts being served before the start of the time window. Default: |
minute |
Type: number Penalty for each minute of early arrival when the location starts being served before the start of the time window. Default: |
time_windows_unloading_penalty_late
Penalty components for late visits (used instead of out_of_time
penalty). Whether the start or the end of service during the visit is used to penalize for lateness is determined by the penalize_late_service
option.
Name |
Description |
fixed |
Type: number Fixed penalty applied if the location is visited after the end of the time window. Default: |
minute |
Type: number Penalty for each minute of lateness, when the location is visited after the end of the time window. Default: |
time_windows_unloading_penalty_out_of_time
Penalty components for time window failure. Can be used to set the values of early
and late
options simultaneously, and each value is overridden if the respective option is also defined.
Name |
Description |
fixed |
Type: number Fixed penalty applied if the location is visited outside of the time window. See the specifications of Default: |
minute |
Type: number Penalty for each minute of lateness or early arrival when the location is visited outside of the time window. See the specifications of Default: |
incompatibilities_types_item
Name |
Description |
other_type* |
Type: string Load type of the incompatible order. |
self_type* |
Type: string Load type of the current order. |
incompatibilities_zones_item
Name |
Description |
other_zone* |
Type: string Load type of the incompatible order. |
self_zone* |
Type: string Load type of the current order. |
raw_metrics_raw_metrics_item
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
raw_metrics_subcosts_item
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
subcosts_raw_metrics_item
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
subcosts_subcosts_item
The value of an arbitrary cost.
Name |
Description |
name* |
Type: string |
value* |
Type: number |
201 Created
Task has started.
Body
application/json
{
"id": "string",
"message": "string",
"status": {
"cancelled": 0,
"completed": 0,
"estimate": 0,
"queued": 0,
"started": 0
}
}
Name |
Description |
id* |
Type: string Task unique id. |
status* |
Type: task_info_1_status Task statuses object. Keys are task statuses, values are UNIX timestamps for corresponding status. Possible status transits:
|
message |
Type: string Human-readable description of task state. |
202 Accepted
Task has been queued for execution.
Body
application/json
{
"id": "string",
"message": "string",
"status": {
"cancelled": 0,
"completed": 0,
"estimate": 0,
"queued": 0,
"started": 0
}
}
Name |
Description |
id* |
Type: string Task unique id. |
status* |
Type: task_info_1_status Task statuses object. Keys are task statuses, values are UNIX timestamps for corresponding status. Possible status transits:
|
message |
Type: string Human-readable description of task state. |
404 Not Found
Requested task is not found.
Body
application/json
{
"error": {
"incident_id": "string",
"message": "string"
}
}
Name |
Description |
error* |
Type: error_2_error Error description. |
410 Gone
Task was deleted or archived.
Body
application/json
{
"error": {
"incident_id": "string",
"message": "string"
}
}
Name |
Description |
error* |
Type: error_2_error Error description. |
500 Internal Server Error
Server error during operation.
Body
application/json
{
"error": {
"incident_id": "string",
"message": "string"
}
}
Name |
Description |
error* |
Type: error_2_error Error description. |