Public Transit API v3 Developer's Guide

Isochrone

User Story

The user wants to retrieve a list of transit stations that are located 20 minutes away from the Sydney Opera House (-33.857023,151.215098) at 8.15 a.m.

Note: This service is subject to Terms and Conditions as described in Supplier Terms for Developers Using HERE Location Platform APIs.

Request

The query parameter center specifies the location of the search. The time parameter is specified in ISO 8601 format, 2020-10-24T08:15:00. The maximum duration of the journey maxDur 20, specified in minutes.

https://transit.ls.hereapi.com/v3/isochrone.json
?apiKey={YOUR_API_KEY}
&center=-33.857023,151.215098
&maxDur=20
&time=2020-10-24T08%3A15%3A00
Note: This example uses a HERE API Key to authenticate your request. For information on other possible options, see Authentication Guide. For examples of how to use the other authentication options with the Public Transit API v3, see Authentication Examples.

Response

The response to the request contains the following information blocks:
  • a list of destinations
  • each station element includes the following information:
    • duration from the location of the search
    • station ID
    • name of the station
    • geocoordinates of the station
{
  "Res": {
    "serviceUrl": "http://ip-10-124-93-102.eu-west-1.com:8080/hafasproxy/G1A",
    "Isochrone": {
      "time": "2018-07-16T08:15:00",
      "timespan": 0,
      "max_dur": "PT20M",
      "max_change": 3,
      "x": -84.39428,
      "y": 33.757867,
      "IsoDest": [
        {
          "Stn": [
            {
              "id": "402521669",
              "name": "Marietta St @ Centennial Olympic Park Dr",
              "x": -84.393433,
              "y": 33.757864
            }
          ],
          "duration": "PT01M"
        },
        {
          "Stn": [
            {
              "id": "402522215",
              "name": "Marietta St @ Centennial Olympic Park Dr",
              "x": -84.393063,
              "y": 33.75738
            }
          ],
          "duration": "PT02M"
        },
        {
          "Stn": [
            {
              "id": "402521361",
              "name": "Marietta St NW @ Ted Turner Dr",
              "x": -84.392672,
              "y": 33.757005
            }
          ],
          "duration": "PT02M"
        },
        {
          "Stn": [
            {
              "id": "402521362",
              "name": "Marietta St NW @ Ted Turner Dr",
              "x": -84.392443,
              "y": 33.756897
            }
          ],
          "duration": "PT03M"
        },
        {
          "Stn": [
            {
              "id": "722021193",
              "name": "Marietta St & Spring St",
              "x": -84.392883,
              "y": 33.757017
            }
          ],
          "duration": "PT03M"
        },
        {
          "Stn": [
            {
              "id": "722021194",
              "name": "Marietta St & Fairlie St",
              "x": -84.392036,
              "y": 33.756206
            }
          ],
          "duration": "PT04M"
        },

        ... more lines ...

        {
          "Stn": [
            {
              "id": "402511719",
              "name": "East Point Station",
              "x": -84.440542,
              "y": 33.677424
            }
          ],
          "duration": "PT20M"
        },
        {
          "Stn": [
            {
              "id": "722021198",
              "name": "Courtland St & Ellis St",
              "x": -84.384231,
              "y": 33.75838
            }
          ],
          "duration": "PT20M"
        }
      ]
    }
  }
}