HERE Routing API 7
In maintenance
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.