6.6 Load KPI Object

A load KPI object contains the KPIs for an individual load within a single vehicle’s route.

1. Field: load_id
   Type: Number (integer).
   Description: A integer assigned to each distinct load for a route by the optimiser. This is the index of the load in the loads field of a solution object.
2. Field: start_stop_id
   Type: Number (integer).
   Description: The stop_id of the stop which starts the load.
3. Field: end_stop_id
   Type: Number (integer).
   Description: The stop_id of the stop which ends the load.
4. Field: cost
   Type: Number.
   Description: The total cost for the load.
5. Field: loaded_distance
   Type: Number.
   Description: The transit distance from the first pickup to the last of delivery in the load.
6. Field: empty_distance_before
   Type: Number.
   Description: For the first load, this is the distance from the START stop to the first pickup; otherwise it is the distance from the final delivery of the previous load to the first pickup of this load.
7. Field: empty_distance_after
   Type: Number.
   Description: For the final load, this is the distance from the final delivery to the FINISH stop; otherwise it is the distance from the final delivery of this load to the first pickup of the next load.
8. Field: delivery_distance
   Type: Number.
   Description: The transit distance while making deliveries as part of the load.
9. Field: work_time
   Type: String (HH:MM).
   Description: The total time from the arrival at the first PICKUP stop to the departure of the last DELIVERY stop in the load.
10. Field: transit_time
    Type: String (HH:MM).
    Description: The time spent in transit during this load.
11. Field: service_time
    Type: String (HH:MM).
    Description: The service time during this load. (See Service Time in Section  2.12.)
12. Field: site_time
    Type: String (HH:MM).
    Description: The site time during this load. (See Site Time in Section  2.10.)
13. Field: idle_time
    Type: String (HH:MM).
    Description: The time spent idle for this load.

14. Field: break_time
    Type: String (HH:MM).
    Description: The time spent on break during this load.

    15.Field: weight
    Type: Number.
    Description: The cumulative weight carried by the vehicle in the load.
15. Field: volume
    Type: Number.
    Description: The cumulative volume carried by the vehicle in the load.
16. Field: weight_utilization
    Type: Number.
    Description: A number between [0, 1] that represents the fraction of the vehicle’s maximum weight used during the load.
17. Field: volume_utilization
    Type: Number.
    Description: A number between [0, 1] that represents the fraction of the vehicle’s maximum volume used during the load.
18. Field: number_of_deliveries
    Type: Number (integer).
    Description: The number of DELIVERY stops in the load.
19. Field: assigned_orders
    Type: Number (integer).
    Description: The number of orders assigned to this load.
20. Field: pickup_soft_time_window_early
    Type: String (HH:MM).
    Description: If there are orders with pickup soft time windows, then this is the total amount of time that orders were picked up early in the load.

21. Field: pickup_soft_time_window_late
    Type: String (HH:MM).
    Description: If there are orders with pickup soft time windows, then this is the total amount of time that orders were picked up late in the load.

    23.Field: delivery_soft_time_window_early
    Type: String (HH:MM).
    Description: If there are orders with delivery soft time windows, then this is the total amount of time that orders were delivered early in the load.
    24.Field: delivery_soft_time_window_late
    Type: String (HH:MM).
    Description: If there are orders with delivery soft time windows, then this is the total amount of time that orders were delivered late in the load.