6.6 Load KPI Object
A load KPI object contains the KPIs for an individual load within a single vehicle’s route.
- Field: load_id
Type: Number (integer).
Description: An 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. - Field: start_stop_id
Type: Number (integer).
Description: The stop_id of the stop which starts the load. - Field: end_stop_id
Type: Number (integer).
Description: The stop_id of the stop which ends the load. - Field: cost
Type: Number.
Description: The cost for the load. - Field: revenue
Type: Number.
Description: The revenue for the load. - Field: profit
Type: Number.
Description: The profit or loss for the load. Profit is the difference between revenue and cost. - Field: loaded_distance
Type: Number.
Description: The transit distance from the first pickup to the last delivery in the load. - 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. - 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. - Field: delivery_distance
Type: Number.
Description: The transit distance while making deliveries as part of the load. - 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. - Field: transit_time
Type: String (HH:MM).
Description: The time spent in transit during this load. - Field: service_time
Type: String (HH:MM).
Description: The service time during this load. (See Service Time in Section x16-380002.122.12.) - Field: site_time
Type: String (HH:MM).
Description: The site time during this load. (See Site Time in Section x14-240002.102.10.) - Field: idle_time
Type: String (HH:MM).
Description: The time spent idle for this load. -
Field: break_time
Type: String (HH:MM).
Description: The time spent on break during this load.17.Field: weight
Type: Number.
Description: The cumulative weight carried by the vehicle in the load. - Field: volume
Type: Number.
Description: The cumulative volume carried by the vehicle in the load. - 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. - 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. - Field: number_of_deliveries
Type: Number (integer).
Description: The number of DELIVERY stops in the load. - Field: assigned_orders
Type: Number (integer).
Description: The number of orders assigned to this load. - 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. -
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.25.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.26.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.

