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: 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.
  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 cost for the load.
  5. Field: revenue
    Type: Number.
    Description: The revenue for the load.
  6. Field: profit
    Type: Number.
    Description: The profit or loss for the load. Profit is the difference between revenue and cost.
  7. Field: loaded_distance
    Type: Number.
    Description: The transit distance from the first pickup to the last delivery in the load.
  8. 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.
  9. 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.
  10. Field: delivery_distance
    Type: Number.
    Description: The transit distance while making deliveries as part of the load.
  11. 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.
  12. Field: transit_time
    Type: String (HH:MM).
    Description: The time spent in transit during this load.
  13. Field: service_time
    Type: String (HH:MM).
    Description: The service time during this load. (See Service Time in Section x16-380002.122.12.)
  14. Field: site_time
    Type: String (HH:MM).
    Description: The site time during this load. (See Site Time in Section x14-240002.102.10.)
  15. Field: idle_time
    Type: String (HH:MM).
    Description: The time spent idle for this load.
  16. 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.
  17. Field: volume
    Type: Number.
    Description: The cumulative volume carried by the vehicle in the load.
  18. 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.
  19. 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.
  20. Field: number_of_deliveries
    Type: Number (integer).
    Description: The number of DELIVERY stops in the load.
  21. Field: assigned_orders
    Type: Number (integer).
    Description: The number of orders assigned to this load.
  22. 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.
  23. 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.