HERE Map Tile v2 Developer's Guide

Metadata Generation Parameter

The user wants to obtain metadata information for an image showing a map tile for an area near Friedenau in Berlin, Germany in order to know the position of the labels to enable interactivity.

Note: Two possible metainfo requests are shown as examples, using the mgen parameter. For more information about metainfo tile requests, see also Metainfo Tiles.

Note: These examples use a HERE API Key to authenticate your request. For the available authentication options, see the Identity & Access Management Developer Guide.

Original Map Tile

The tile that the user wants to find more information about is obtained by the following request:

https://2.base.maps.ls.hereapi.com/maptile/2.1/maptile/newest/normal.day/14/8799/5376/256/png8
?apiKey={YOUR_API_KEY}

The response to the request delivers the following image:

Request with Metadata Only

The code block below demonstrates a complete request for a metadata map tile.

https://2.base.maps.ls.hereapi.com/maptile/2.1/maptile/newest/normal.day/14/8799/5376/256/png8
?apiKey={YOUR_API_KEY}
&metadata=metaonly

Note: Parts of the response have been modified as described in the introduction to Examples.

Response with Metadata Only

The response to the request delivers the following Meta Info Tile as a JSON object.


      {
  "metadata": {
    "street labels": [
      {
        "name": "Hauptstraße", "font size": "13",
        "vertices": [ { "x": 139, "y": 0 },  { "x": 177, "y": -35 },  { "x": 183, "y": -40 },  { "x": 196, "y": -49 } ]
      },
      ...
    ],
    "labels": [
      {
        "name": "Cheruskerpark",
        "type": "TEXT",
        "bounding boxes": [
          {
            "left": 207,
            "top": -4,
            "width": 74.72,
            "height": 11.75
          }
        ]
      },
      ...,
      {
        "name": "Innsbrucker Platz",
        "type": "TRANSIT_STOP",
        "bounding boxes": [
          {
            "left": 56,
            "top": 84,
            "width": 23,
            "height": 12
          },
          {
            "left": 23,
            "top": 71,
            "width": 88.14,
            "height": 11.75
          }
        ]
      }
    ]
    "city center labels": []
  }
}

Request with mgen=2

In this request, the parameter mgen specifies that the response is to use a metadata map tile. This is a text based (JSON) tile with the relevant objects in it, such as street labels, city labels or icons. Each of these objects have certain properties, such as

positioning through bounding boxes
latitude and longitude
road icons with icon information, for example for highway signs

https://2.base.maps.ls.hereapi.com/maptile/2.1/maptile/newest/normal.day/14/8799/5376/256/png8
?apiKey={YOUR_API_KEY}
&metadata=metaonly
&mgen=2

Response with mgen=2

The response to the request delivers the following Meta Info Tile as a JSON object:


      
      {
  "metadata": {
    "street labels": [
      {
        "name": "Hauptstraße", "font size": "13",
        "vertices": [ 139, -0.16, 173.71, -31.71, 177.21, -34.88, 182.53, -39.48, 196.24, -48.32 ]
      },
      ...
    ],
    "labels": [
      {
        "name": "Cheruskerpark", "type": "TEXT",
        "bounding boxes": [
          {
            "box 2": [ 207.27, -3.72, 74.72, 11.75 ]
          }
        ]
      },
      ...,
      {
        "name": "100", "type": "ROADSIGN",
        "bounding boxes": [
          {
            "box 1":[ 144.59, 151.48, 28, 20 ]
          }
        ],
        "region": "DEU", "category": 0, "route name": "A100", "route level": 2,
        "uri": "http://image.maps.ls.hereapi.com/mia/1.6/roadsign?category=0&region=DEU&label=A100&route_level=2&apiKey={YOUR_API_KEY}"
      }
      ...,
    ],
    "city center labels": [],
    "buildings": [],
    "transit stops": [
      {
        "name": "Friedenau",
        "bounding boxes": [
          {
            "box 1":[ 32, 240.20, 11, 12 ]
          },
          {
            "box 2":[ 11.96, 227.20, 51.08, 11.75 ]
          }
        ],
        "info": [
          {
            "position": {
              "latitude": 52.469995,
              "longitude": 13.340428
            },
            "official name": "Friedenau", "places id": "721680032",
            "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": []
  }
}

Note: Parts of the response are modified as described in the introduction to Examples.