Metainfo with Labels
The user wants to make labels on the map interactive to offer, for example, several options for having the map display additional information. This requires obtaining metadata information about an image showing a map tile that includes different kinds of labels.
Mountain Peak Labels Request
The first request obtains a tile with the mountain peak labels of Vesuvius Volcano in Italy
:
https://2.base.maps.ls.hereapi.com/maptile/2.1/maptile/newest/normal.day/17/70789/49227/256/png8
?apiKey={YOUR_API_KEY}
Mountain Peak Labels Response
The response delivers the following image:

Pedestrian Point Labels Request
In this request, the pedestrian.day
scheme obtains the pedestrian point labels in Kiev
:
https://2.base.maps.ls.hereapi.com/maptile/2.1/maptile/newest/pedestrian.day/19/306646/176817/256/png8
?apiKey={YOUR_API_KEY}
Pedestrian Point Labels Response
The response to the request delivers the following image:

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/pedestrian.day/19/306646/176817/256/png8
?apiKey={YOUR_API_KEY}
&metadata=metaonly
&mgen=2
Unclassified Labels
Objects on the map tiles that have other kinds of labels are for example:
- land use objects (parks)
- hydro labels (oceans, seas, rivers, lakes)
- country or continent names
Label Type and Icon
Adding the query parameters metadata
and mgen
to the requests above obtains the information required to locate a label in order to make it interactive.
The response is a metadata
JSON object with labels
that specifies the label type using the type
attribute (MOUNTAIN_PEAK
for a mountain peak label in the code example below) The box 1
array for the label icon in the format [x, y, width, height]
represents the icon's bounding box. box 2
represents the bounding box for the text label in the same format.
{
"metadata": {
"street labels": [],
"labels": [
{
"name": "Mount Vesuvius",
"type": "MOUNTAIN_PEAK",
"bounding boxes": [
{
"box 1":[ 106, 226.80, 10, 10 ]
},
{
"box 2":[ 90, 195.80, 41.53, 31 ]
}
],
"city center labels": [],
"buildings": [],
"transit stops": [],
"POIs": []
}
}
type
attribute also specifies pedestrian labels (PEDESTRIAN_POINT
) and unclassified labels (TEXT
). But since pedestrian labels do not have a text label and unclassified labels do not have an icon, label
contains only a representation of one label (box 1
) for these label types.