Public Transit API Developer's Guide

Transit Route

To find a transit route, the following mandatory parameters are required in the request:

  • your authentication credentials, app_id and app_code (see Acquiring Credentials for more details)
  • the start and destination coordinates
  • and time of the departure.

The example below requests transit routes for all transit modes departing from New York Penn Station to JFK Airport, at a time of 7:30 am on a specified date.

https://cit.transit.api.here.com/metarouter/rest/routeservice/v2/route
?app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}
&routing=all
&startX=-73.99162351623576
&startY=40.751036894211815
&destX=-73.79532754484204
&destY=40.645158460052684
&time=2017-04-11T07:30:00

By default, the following information will be returned:

  • A total of 3 transit connections or journeys
  • Each journey will include the following information:
    • Multiple transit segments, each segment (representing either a pedestrian or a transit) containing departure/arrival times, duration and coordinates
    • The transit segment will show the actual stops/stations of departure, arrival and all intermediate stops in between
  • A set of operators who run the services included in the journeys, including operator code, operator name and links to operator websites, if any.

You can further refine the route results by submitting the requests with these optional parameters:

  • prod parameter defines which transit types are to be included in the response. See Transit Modes for more details on how this parameter is used
  • arrival boolean parameter will show the transit journeys to arrive (rather than depart) by a given time
  • graph boolean parameter will include an additional coordinate pairs representing the transit routes of the journeys, which can then be plotted over a map for visualization purposes
  • changes parameter can be set to limit no of changes or transfers during a journey, for example, return only direct routes or routes with maximum 1 transfer
  • walk parameter can be used to define how far or how quickly you wish to walk to/from the transit stop/station. By default, it is assumed that a person walks at the rate of 1m/s and is willing to walk up to 2km to the nearest transit stop/station.

For a complete set of these parameters see Transit Routing.

You cannot use this account to purchase a commercial plan on Developer Portal, as it is already associated to plans with different payment methods.

To purchase a commercial plan on Developer Portal, please register for or sign in with a different HERE Account.

Something took longer than expected.

The project should be available soon under your projects page.

Sorry, our services are not available in this region.

Something seems to have gone wrong. Please try again later.

We've detected that your account is set to Australian Dollars (AUD).
Unfortunately, we do not offer checkouts in AUD anymore.
You can continue using your current plan as normal, but to subscribe to one of our new plans,
please register for a new HERE account or contact us for billing questions on selfservesupport@here.com.