Public Transit API v3 Developer's Guide

Introduction

Note: We’re very excited to announce and present to you a new set of HERE Location Services that are leveraging the HERE platform and can be easily accessed through our Developer Portal at developer.here.com. These newly released versions of HERE Location Services provide a unified API framework, while leveraging the HERE Platform, infrastructure, making it easy and efficient for any customer to adopt the breadth of our Location Services offering and beyond. As a customer of our Location Services you can now benefit from a set of redesigned and aligned APIs, as well as a streamlined architecture with compatibility across all location services, as they’re sharing the same HERE map data, authentication and authorization methods as well as API specification. In addition, the newly released HERE Location Services are leveraging fresher map content through higher map update frequency and faster availability of new regions (e.g. such as the recently integrated high detail map of Japan) realized today through the HERE platform. With the new service framework in place, we are also on our way to delivering new functionalities that will only become available through the newly released HERE Location Services.

Transit API v8: enabling improved functionality of Transit Routing and Next Departures features:

  • Station Search now supports access points data, so it is possible to search for stations’ specific exits and gates (useful for pick-up or drop-off use case).
  • Provides new, improved iteration of Service Alerts feature.
Note: This service is no longer being actively developed and we do not update the content. We will only provide critical fixes for this service in future. Instead, you can use the new Public Transit API v8 service.

This document introduces the Public Transit API v3. It explains key concepts and provides examples. It documents resources, query parameters, response structures and data types.

For the terms and conditions covering this documentation, see the HERE Documentation License.

What Is the Public Transit API v3?

The Public Transit API v3 is a REST API that allows you to use agency data, external services and data collected by HERE to discover public transit options, request public transit routes and transit related information.

The Public Transit API has a number of endpoints that center around two major features:

  • Discovery - shows stations and departure of transit services around a given location, transit stations that could be reached within a certain time frame from a given location and shows transit line(s) details at any given station
  • Routing - provides the most efficient and relavant transit routes between a given pair of locations.

Why Use the Public Transit API v3?

The Public Transit API v3 provides resources to address the following high-level use cases:

Table 1. Main features of the HERE Public Transit API v3
Feature Description
Discover public transit options in a geolocation. Based on a WGS-84 compliant latitude and longitude, search for nearby stations, determine what public transit information is available in the area (e.g. transit lines and departure times), and discover how far a person can travel by public transit within a certain time frame.
Request public transit routes. Based on WGS-84 compliant start and end points, request public transit routes making use of all available transit types in a given city or metropolitan area.

You can tailor transit route calculation for different use cases by:

  • defining routes based on arrival time vs departure time
  • filtering specific forms of transit, such as rail and metro only
  • planning routes hours or days in advance
  • setting a maximum distance for the walk to the nearest transit stop/station or the speed of the walk
  • defining how many changes or transfers the journey may include
  • requesting turn-by-turn maneuvers for walk navigation at the beginning and end of the journey
  • requesting route graph of the journeys in order to view the route over a map.