HERE Public Transit API 3
In maintenance
Public Transit API v3 Developer's Guide

Transit Routing

Use the route resource to request routes between two sets of WGS-84 compliant geocoordinates.

Maximum waiting time between transfers is 90 minutes.

.../v3/route.{format}?<parameter>=<value>...

Table 1. Mandatory Parameters
Parameter Data Type Description
app_id String

Typically, but not guaranteed to be, 20
bytes Base64 URL-safe encoded string used for the authentication of
the client application. If you use the app ID/app code option, you
need to include an app_id and
app_code with every request. For the available authentication options, see the Identity & Access Management Developer Guide.

app_code String

Typically, but not guaranteed to be, 20
bytes Base64 URL-safe encoded string used for the authentication of
the client application. If you use the app ID/app code option, you
need to include an app_id and
app_code with every request. For the available authentication options, see the Identity & Access Management Developer Guide.

apiKey String

A 43-byte Base64 URL-safe encoded string used for the authentication of the client
application. As a logged in user, you can generate it at
https://developer.here.com/projects.
API Keys never expire but you can invalidate your API Keys at any time. You cannot have more
than two API Keys for one app at the same time. You must include an apiKey with every request. For the full authentication story, see the Identity & Access Management Developer Guide.

dep Double,Double,String Specifies the latitude, the longitude and the name of the starting point of your route separated by commas. Where the latitude is in WGS 84-compliant degrees between -90 and 90, the longitude is in WGS 84-compliant degrees between -180 and 180 and the name can be omitted.
arr Double,Double,String Specifies the latitude, the longitude and the name of the end point of your route separated by commas. Where the latitude is in WGS 84-compliant degrees between -90 and 90 and the longitude is in WGS 84-compliant degrees between -180 and 180 and the name can be omitted.
time DateTime Specifies the time in ISO 8601 (for example, 2020-10-24T01:23:45) format.
• When the optional timezone offset is not specified, time is assumed to be local. In such case, all xs:dateTime in the response are also returned without timezone.
• If timezone offset is specified, all xs:dateTime in the response will be returned with the proper timezone valid at each location. The requested time is converted to local time at departure (if arrival=0) or destination (if arrival=1).
Table 2. Optional Parameters
Parameter Data Type Description
arrival Integer Switches between arrival and departure time. If enabled, makes routing request to interpret time as arrival time for the journey.

1 (enabled), 0 (disabled)

The default is 0.

max Integer Specifies the number of following departure/arrivals the response should include. The possible values are:

1-6

The default is 3.

callbackFunc String Specifies an arbitrary string used to wrap the JSON object in the response.
callbackId Integer If you specify the parameter callbackId, specifies the first argument to the function specified by the callbackFunc.
changes Integer Specifies the maximum number of changes or transfers allowed in a route.

0-6 or -1.

The default is -1 (which disables the filter, or unlimited no of changes permitted).

Note: In areas where this parameter is not supported, the route response includes the attribute sup_changes="0" in the Connection node.
details Integer Requests the inclusion of a list of intermediate stops within the routes in the response. If enabled, the response includes stop/station names, WGS-84 geocoordinates, and the departure/arrival times at the stops.

1 (enabled), 0 (disabled)

The default is 1.

graph Integer Requests coordinate pairs to allow the drawing of a polyline for the route. The possible values are:

1 (enabled), 0 (disabled)

The default is 0.

lang String Specifies the language of the response. The value complies with the ISO 639-1 standard and defaults to en.
modes String

Specifies the transit type filter used to determine which types of transit to include in the response.
By default the parameter is omitted, meaning all supported transit types are permitted.
See Transit Modes page for more information.

strict Integer Specifies if the number of returned connections must be strict.

1 (enabled), 0 (disabled)

The default is 0.

units String Units of measurement used, for example, in guidance instructions. The possible values are:
• metric
• imperial

The default is metric.

walk String Specifies a maximum walking distance and walking speed in the format max_distance,speed as follows:
• max_distance: range 0-6000 (meters).
• speed: range 50-200 (half of normal speed to double the normal speed).

The default value is 2000,100.

Note: In areas where speed or max_dist parameters are not supported, the route response includes the attributes sup_speed=0 or sup_max_dist=0 in the Connections node.
maneuvers Integer The response includes turn-by-turn maneuvers information for the relevant transport mode, e.g. wak, taxi, car share, etc.

1 (enabled), 0 (disabled)

The default is 0.

firstLastMile Integer The response includes first/last mile of a long-distance connection. If set to 0, response will only show the long distance sections in between and excludes the initial and final connections.

1 (enabled), 0 (disabled)

The default is 1.

routingMode String
The alternative given in the response are based on the chosen routing mode.
• When "schedule" is chosen, the returned routes will be based on time table data and real time is only given as an additional information.
• When "realtime" is chosen, the returned routes will be calculated with regards to real time information (impossible transitions due to delay will be filtered out).

The default is "schedule".

See rt_aware flag in the Connection tag of the response for details.