Map Tile API Developer's Guide

Public Transit Additional Information

The user wants to obtain additional information about a Public Transit Stop in order to display it in text mode.

Request

The code block below demonstrates a complete request for the public transit stop.

https://2.base.maps.cit.api.here.com/maptile/2.1/maptile/newest/normal.day/16/35205/21495/256/png8
?app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}
&metadata=metaonly
&mgen=2

Response

The image shown by this tile request not using metadata would be as follows.
Figure 1. Public Transit Map Tile
Note: For information on how to create a selectable area, see Selecting Public Transit Stops.
The response to the request delivers the following JSON object.
{
  "metadata": {
    "street labels":[ ... ],
    "labels":[],
    "city center labels":[],
    "buildings":[ ... ],
    "transit stops":
      {
        "name": "Stadtmitte",
        "type": "TRANSIT_STOP",
        "bounding boxes": [
          {
            "box 1":[ 136.50, 177.02, 14, 14 ]
          },
          {
            "box 2": [ 113.22, 163.02, 60.56, 13 ]
          }
        ],
        "info": [
          {
            "position": {"latitude":52.510475, "longitude":13.389920},
            "official name": "Stadtmitte",
            "places id": "721680928",
            "operating hours": {
              "Monday": [["0:0:0","24:0:0"]],
              ...,
              "Holiday": [["0:0:0","24:0:0"]],
            },
            "parking hours": {
              "Monday": [["0:0:0","24:0:0"]],
              ...,
              "Holiday": [["0:0:0","24:0:0"]]
            }
          }
        ]
      }
    ],
    "POIs": []
  }
}
In this object, the following properties are of interest to get the geo location:
  • places id: contains the places identifier of the transit stop
  • operating hours: contains an array of days and times when the public transit stop operates
  • parking size: contains the parking size (if applicable)
  • parking hours: contains the allowed parking hours (if applicable)
Note: This additional information is not included when it is not available, so the response may be shorter compared to the one above. Also, parts of the response are modified as described in the introduction to Examples.

The coverage of places with an ID as a property is growing. Mainly the locations in the US contain a places ID, as in the following request obtaining a tile with a public transit stop in Chicago.

https://2.base.maps.cit.api.here.com/maptile/2.1/maptile/newest/normal.day/16/16815/24358/256/png8
?app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}
&metadata=metaonly
&mgen=2