Intermodal Routing API Developer's Guide

Park and Ride Routing

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

https://mobility.api.here.com/v1/route
  ?parameter=value
  &...
Table 1. Mandatory Parameters
Parameter Data Type Description
profile String

Set this parameter to parkandride to enable Park and Ride routing.

app_id String

A 20 bytes Base64 URL-safe encoded string used for the authentication of the client application.
You must include an app_id and app_code with every request. To get an app_code assigned to you, please see Acquiring Credentials.

app_code String

A 20 bytes Base64 URL-safe encoded string used for the authentication of the client application.
You must include an app_id and app_code with every request. To get an app_code assigned to you, please see Acquiring Credentials.

dep String Specifies the latitude, longitude and (optional) descriptive text for the location of the starting point of your route. Latitude and longitude are given in WGS 84-compliant degrees. Latitude values are between -90 and 90, longitude values are between -180 and 180. Examples:
  • with descriptive text: 40.751036894211815,-73.99162351623576,NY Penn Station
  • without descriptive text: 40.751036894211815,-73.99162351623576
arr String Specifies the latitude, longitude and (optional) descriptive text for the location of the end point of your route. Latitude and longitude are given in WGS 84-compliant degrees. Latitude values are between -90 and 90, longitude values are between -180 and 180. Examples:
  • with descriptive text: 40.751036894211815,-73.99162351623576,NY Penn Station
  • without descriptive text: 40.751036894211815,-73.99162351623576
time DateTime Specifies the time in ISO 8601 (for example, 2017-12-25T01:23:45) format.
Table 2. Optional parameters for Park and Ride mode
Parameter Data Type Description
car_change_strategy String Strategy to apply for finding Park and Ride routes.
Possible String values are:
  • park_late (default) - switch from car to public transit as soon as possible after entering the destination city's limits
  • park_early - try to switch from car to public transit as early as possible

The default is park_late.

modes String

Specifies the transport mode filter used to determine which types of transport should be excluded in the response. It is a string of the following format:

  • -code_1,-code_2,...,-code_N - disable specified vehicle types and enable everything else

See List of Transport Codes in Request and Response for a complete list of supported vehicle types.

details Integer Requests the inclusion of a list of intermediate stops within the the transit segment part of 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.

intermodal_max Integer

Controls the number of alternative park and ride routes in the response.

Values are between 1 and 6.

The default value is 3.

maneuvers Integer Requests turn-by-turn walk maneuvers information in the response.

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.

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