AggregatedMetrics

  • This document outlines the aggregated metrics for ShipmentRoute and OptimizeToursResponse within Google Maps Route Optimization.

  • Metrics include shipment count, travel/wait/delay/break/visit/total durations, travel distance, and maximum loads.

  • All durations are represented in seconds with up to nine fractional digits using the Duration format.

  • Maximum loads are provided as a map, keyed by quantity and valued by the corresponding VehicleLoad object.

  • These metrics offer insights into the overall performance and resource utilization of routes and solutions.

Aggregated metrics for ShipmentRoute (resp. for OptimizeToursResponse over all Transition and/or Visit (resp. over all ShipmentRoute) elements.

JSON representation 
{
  "performedShipmentCount": integer,
  "travelDuration": string,
  "waitDuration": string,
  "delayDuration": string,
  "breakDuration": string,
  "visitDuration": string,
  "totalDuration": string,
  "travelDistanceMeters": number,
  "maxLoads": {
    string: {
      object (VehicleLoad)
    },
    ...
  },
  "performedMandatoryShipmentCount": integer,
  "performedShipmentPenaltyCostSum": number
}
Fields
performedShipmentCount

integer

Number of shipments performed. Note that a pickup and delivery pair only counts once.
travelDuration

string (Duration format)

Total travel duration for a route or a solution.

A duration in seconds with up to nine fractional digits, ending with 's'. Example: "3.5s".
waitDuration

string (Duration format)

Total wait duration for a route or a solution.

A duration in seconds with up to nine fractional digits, ending with 's'. Example: "3.5s".
delayDuration

string (Duration format)

Total delay duration for a route or a solution.

A duration in seconds with up to nine fractional digits, ending with 's'. Example: "3.5s".
breakDuration

string (Duration format)

Total break duration for a route or a solution.

A duration in seconds with up to nine fractional digits, ending with 's'. Example: "3.5s".
visitDuration

string (Duration format)

Total visit duration for a route or a solution.

A duration in seconds with up to nine fractional digits, ending with 's'. Example: "3.5s".
totalDuration

string (Duration format)

The total duration should be equal to the sum of all durations above. For routes, it also corresponds to:

[ShipmentRoute.vehicle_end_time][google.maps.routeoptimization.v1.ShipmentRoute.vehicle_end_time] - [ShipmentRoute.vehicle_start_time][google.maps.routeoptimization.v1.ShipmentRoute.vehicle_start_time]

A duration in seconds with up to nine fractional digits, ending with 's'. Example: "3.5s".
travelDistanceMeters

number

Total travel distance for a route or a solution.
maxLoads

map (key: string, value: object (VehicleLoad))

Maximum load achieved over the entire route (resp. solution), for each of the quantities on this route (resp. solution), computed as the maximum over all Transition.vehicle_loads (resp. ShipmentRoute.metrics.max_loads.
performedMandatoryShipmentCount

integer

Number of mandatory shipments performed.

Experimental: This field's behavior or existence may change in future.
performedShipmentPenaltyCostSum

number

The sum of the Shipment.penalty_cost of the performed shipments.

Experimental: This field's behavior or existence may change in future.