Routing API v7 Developer's Guide

RouteSummaryType

This type provides summary information for the entire route. This type of information includes travel time, distance, and descriptions of the overall route path.

RouteSummaryType elements used in calculate route and get route responses:

Element	Description
`Distance`	`DistanceType` Indicates total travel distance for the route, in meters.
`TrafficTime`	common:DurationType Contains the travel time estimate in seconds for this element, considering traffic and transport mode. Based on the `TrafficSpeed`. The service may also account for additional time penalties, so this may be greater than the element length divided by the `TrafficSpeed`.
`BaseTime`	common:DurationType Contains the travel time estimate in seconds for this element, considering transport mode but not traffic conditions. Based on the `BaseSpeed`. The service may also account for additional time penalties, therefore this may be greater than the element length divided by the `BaseSpeed`.
`Flags`	`RouteLinkFlagType` Special link characteristics (like ferry or motorway usage) which are covered by the route.
`TravelTime`	common:DurationType Total travel time in seconds optionally considering traffic depending on the request parameters.
`Text`	`xs:string` Textual description of route summary. Supported languages are US and GB English, French, German, Italian, Polish, Portuguese, Spanish and Traditional Chinese. Element is not provided in case of other languages.
`Co2Emission`	Estimation of the carbon dioxide emission for the given `Route`. The value depends on the `VehicleType` request parameter which specifies the average fuel consumption per 100 km and the type of combustion engine (diesel or gasoline). Unit is kilograms with precision to three decimal places.

RouteSummaryType elements used in calculate matrix responses:

Element	Description
`Distance`	`DistanceType` Indicates total travel distance for the route, in meters.
`TravelTime`	common:DurationType Total travel time in seconds optionally considering traffic depending on the request parameters.
`CostFactor`	`xs:int` An internal cost used for calculating the route. This value is based on the objective function of the routing engine and related to the distance or time, depending on the request settings (such as pedestrian versus car routes). The value may include certain penalties and represents the overall quality of the route with respect to the input parameters. Computing the CostFactor value is computationally less expensive compared to calculating distance or time. Especially for computing matrix routes and 1:n routes this value is preferred over distance or travel time, as it allows computing responses in much less time. CostFactor is also the preferred metric for comparing multiple routes such as for doing trip planning (traveling salesman problem) based on the response of a matrix route calculation. If time and distance is required for only a subset of a matrix route response, it is recommended to query for distance and time separately, instead of requesting these values directly for a matrix request.
`RouteId`	`xs:string` Unique identifier for the Get Route resource to get a corresponding route. Consider `RouteId` as a semi-persistent reference to the route. It may be incompatible between distinct map versions.