Public Transit API Developer's Guide

Reachability of an Area within a Specifed Duration

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, 2018-11-19T08:15:00. The maximum duration of the journey maxDur 20, specified in minutes.

https://transit.api.here.com/v3/isochrone.json
?app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}
&center=33.757867,-84.394280
&maxDur=20
&time=2018-11-19T08%3A15%3A00

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"
        }
      ]
    }
  }
}