6.5 Route KPI Object

A route object describes the planned route for a single vehicle. It has the following fields:

1. Field: route_id
   Type: Number (integer).
   Description: An number assigned to the route by the optimiser. It is the index of the route in the routes field of a solution object.
2. Field: vehicle_id
   Type: String.
   Description: The identifier of the vehicle assigned to this route.
3. Field: cost
   Type: Number.
   Description: The total cost of this route.
4. Field: distance
   Type: Number.
   Description: The total transit distance during the route.
5. Field: loaded_distance
   Type: Number.
   Description: The total transit distance travelled in the route while the vehicle is carrying at least one order.
6. Field: empty_distance
   Type: Number.
   Description: The total transit distance travelled in the route while the vehicle is empty.
7. Field: delivery_distance
   Type: Number.
   Description: The transit distance while making deliveries as part of the route.
8. Field: work_time
   Type: String (HH:MM).
   Description: The total time elapsed from the START to the FINISH stop in the route.
9. Field: transit_time
   Type: String (HH:MM).
   Description: The time spent in transit in the route.
10. Field: service_time
    Type: String (HH:MM).
    Description: The service time incurred in the route. (See Service Time in Section  2.12.)
11. Field: site_time
    Type: String (HH:MM).
    Description: The site time incurred in the route. (See Site Time in Section  2.10.)
12. Field: idle_time
    Type: String (HH:MM).
    Description: The time spent idle in the route.
13. Field: break_time
    Type: String (HH:MM).
    Description: The time spent on breaks in the route.
14. Field: actual_start_time
    Type: String (HH:MM).
    Description: The time the vehicle started the route.
15. Field: actual_finish_time
    Type: String (HH:MM).
    Description: The time the vehicle finished the route.
16. Field: weight
    Type: Number.
    Description: The cumulative weight carried by the vehicle in the route.
17. Field: volume
    Type: Number.
    Description: The cumulative volume carried by the vehicle in the route.
18. Field: assigned_orders
    Type: Number.
    Description: The number of orders assigned to the vehicle in the route.
19. Field: pickup_soft_time_window_early
    Type: String (HH:MM).
    Description: If there are pickup soft time windows present in the orders then the total amount of time that orders were picked up early in the route.
20. Field: pickup_soft_time_window_late
    Type: String (HH:MM).
    Description: If there are pickup soft time windows present in the orders then the total amount of time that orders were picked up late in the route.
21. Field: delivery_soft_time_window_early
    Type: String (HH:MM).
    Description: If there are delivery soft time windows present in the orders then the total amount of time that orders were delivered early in the route.
22. Field: delivery_soft_time_window_late
    Type: String (HH:MM).
    Description: If there are delivery soft time windows present in the orders then the total amount of time that orders were delivered late in the route.
23. Field: number_of_loads
    Type: Number (integer).
    Description: If batched_loads is true, this is the number of loads in the route. (See Section  2.19).
24. Field: load_kpis
    Type: If batched_loads is true, this is an array of load_kpi objects.
    Description: See Section  6.6 for further information.