Migrate to Public Transit Routing v8

This document highlights the most important changes necessary to migrate to the new version (v8).


The missing API versions from v3 to v8 are due to internal version alignment.


This section describes changes in the request.

Parameters Added

This migration does not introduce new parameters.

Parameters Changed

The following parameters are changed in this migration.

Base URL, Version, Resource

Parameter Public Transit Routing v3 Public Transit Routing v8
Base URL string, https://transit.ls.hereapi.com string, https://transit.router.hereapi.com
Version string, /v3 string, /v8
Resource string /route string, /routes

dep vs origin

This migration renames dep parameter (v3) to origin (v8).

dep origin
Format string, {lat},{lng}[,{name}] string, {lat},{lng}[;name={name}]
Behavior Sets WGS-84 compliant departure coordinates. Sets WGS-84 compliant origin coordinates.

arr vs destination

This migration renames arr parameter (v3) to destination (v8).

arr destination
Format string, {lat},{lng}[,{name}] string, {lat},{lng}[;name={name}]
Behavior Sets WGS-84 compliant arrival coordinates. Sets WGS-84 compliant destination coordinates.

time vs departureTime/arrivalTime

This migration renames time parameter (v3) to departureTime/arrivalTime (v8).

time departureTime/arrivalTime
Format DateTime,
Behavior Specifies the departure/arrival time (ISO 8601). When the optional timezone offset is not specified, time is assumed to be local. Sets departure time. See RFC 3339, section 5.6.

max vs alternatives

This migration renames max parameter (v3) to alternatives (v8).

max alternatives
Format integer, 1-6 integer 0-5
Behavior Sets the max number of routes to be returned in the response. By default, it is set to 3. Sets the number of alternative routes to return aside from the optimal route. By default, it is set to 0.

walk vs pedestrian[maxDistance], pedestrian[speed]

walk pedestrian[maxDistance], pedestrian[speed]
Format integer 0-6000, integer 50-200 integer 0-6000, float 0.5-2
Behavior Maximum walking distance (meters) and speed (meters per second) . By default, it is set to 2000,100. Maximum walking distance (meters) and speed (meters per second). By default, it is set to 2000,1.

details, graph, maneuvers vs return=intermediate,polyline,actions

This migration renames details, graph, maneuvers parameter (v3) to intermediate, polyline, actions (v8). They can be set through the return (v8) parameter. By default, all options are disables.

details, graph, maneuvers return=intermediate,polyline,actions
Format boolean, 1/0 array of strings intermediate,polyline,...
Behavior Enables/Disables response options. By default, only details is enabled. All options are disabled by default.


The following attributes were added to the sections parameter in response:

  • travelSummary: Enables summary for the travel portion of the section.
  • fares: List of fares/tickets to cover a section of the route.

Parameters Removed

The following parameters are removed in this migration.


This migration removes the Format parameter (v3). The response is always returned in JSON format (v8).


This migration removes arrival parameter (v3) as the departureTime/arrivalTime parameters can now be set individually (v8).


This migration removes strict parameter (v3). By default, it is set to 0 (v8).


This migration removes routingMode parameter (v3). By default, it is set to realtime (v8).


This section describes changes in the response.

Parameters Added

This migration introduces the following parameters in (v8) response:

  • notices: To response object, and routes, and sections parameters
  • spans: For more information, see the Routing API v8 Developer Guide
  • type: Similar to mode parameter (v3)
  • preActions, actions, postActions: Similar to Guidance parameter (v3). For more information, see Action Concept
  • intermediateStops
  • fares: Similar to Tariff parameter (v3)
  • travelSummary: Similar to Journey parameter (v3)
  • agency: Similar to Operators parameter (v3)
  • attributions
  • transport: Similar to Transport in Dep parameter (v3) in sections. For more information, see Transport Concept

Parameters Changed

This migration introduces the following changes to parameters in response (v8):

  • renames the Connection parameter (v3) to routes (v8)
  • renames the Sec parameter (v3) to sections (v8)
  • renames the Dep and Arr parameters (v3) to departure and arrival (v8)
  • renames the Stn parameter (v3) to place (v8)
  • renames the distance parameter (v3) to length (v8)
  • changes the integer mode parameter (v3) to string (v8)
  • renames the x, and y parameters (v3) to lng, and lat (v8)
  • renames the graph parameter (v3) to polyline (v8) and changes its format to Flexible Polyline

Parameters Removed

This migration removes the following parameters in (v8) response:

  • Res
  • valid_until
  • context
  • serviceUrl
  • mode: From sections parameter (v3)
  • transfers
  • duration: From sections parameter (v3)
  • Guidance
  • Freq: From Dep parameter (v3) in sections
  • Journey
  • Tariff
  • Transport
  • Operators


The following table describes the response codes changed in this migration.

v3 error code v8 error code Status code Description
GW100 E602000 400 Bad request Wrong parameter type or parameter missing
I4 N/A 401 Unauthorized for wrong credential, 403 Forbidden for access not allowed N/A
GW0001 N/A 200 OK Returns empty routes list and notice object
GW0002 E602100, E602101, E602102 504 Gateway Timeout, 503 Service Unavailable, 502 Bad Gateway Backend failed to provide a response
GW0006 E602103 500 Internal Server Error Unexpected error
GW0007 N/A 200 OK No support for this API in this area
K9360 E602104 400 Bad request Invalid Period



Public Transit Routing v3 example uses a HERE API Key to authenticate the request. HERE Token Credentials authentication is only possible in Public Transit Routing v8. For information on other possible authentication options, see the Identity & Access Management Guide.

results matching ""

    No results matching ""