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.