Metainfo Tile Format for Metadata Generation Two
- metadata – container for the response
- street labels – array of street labels
- name
- font size
- vertices – array of tile coordinates
- labels – array of labels
- name
- type
- bounding boxes – array of boxes
- city center labels - array of city center labels
- name
- box 1
- box 2
- city center info
- type
- name
- alternative names – array of names
- country code
- name
- country code
- position
- latitude
- longitude
- population
- buildings – array of buildings
- id
- vertices – array of vertices
- polygons – array of polygons
- outlines – array of outlines
- transit stops – array of transit stops
- name
- bounding boxes – array of bounding boxes
- box 1
- box 2
- info – array of transit stop information
- geoposition
- latitude
- longitude
- official name
- informal name
- places id
- operating hours
- Monday
- Tuesday
- Wednesday
- Thursday
- Friday
- Saturday
- Sunday
- Holiday
- parking hours
- Monday
- Tuesday
- Wednesday
- Thursday
- Friday
- Saturday
- Sunday
- Holiday
- geoposition
- POIs – array of Points of Interest (POIs)
- name
- geoposition
- latitude
- longitude
- bounding boxes – array of bounding boxes
- box 1
- box 2
- info - array of POI information
- street labels – array of street labels
{
"metadata": {
"street labels": [],
"labels": [],
"city center labels": [],
"buildings": [],
"transit stops": [],
"POIs": []
}
}
Street labels
"name": "",
"font size": "",
"vertices: []
Name | Type | Description |
---|---|---|
name | String | Name of the street |
font size | String | Font size used to render the label, it is a number displayed as a string |
vertices | Array of tile coordinates | Array containing all vertices needed to draw a polyline that creates a bounding box on the street label, an array of x/y values, as in [ x1, y1, x2, y2 ... ] |
Labels
"name": "",
"type": "",
"bounding boxes": []
Name | Type | Description |
---|---|---|
name | String | Name displayed on the label |
type | String | One of the following types: Mountain Peak, Text, Pedestrian Point, Roadsign When the type is Roadsign, there are additional fields:
|
bounding boxes | Array of Bounding Box | Array containing all the bounding boxes of the label, that can contain a box 1 or box 2. |
City Center Labels
"name": "",
"box 1" : [],
"box 2": [],
"city center info": {
"type": "",
"name": "",
"alternative names": [
[
"",
""
]
],
"country code": "",
"position": {
"latitude":,
"longitude":
},
"population":
}
Name | Type | Description |
---|---|---|
name | String | Name of the city |
box 1 | Bounding Box | Location of the text or icon in the tile |
box 2 | Bounding Box | Location of the text or icon in the tile |
city center info | Structure | Structure containing additional information for a city |
Buildings
- identify buildings within a single tile or across several tiles using a building's unique ID
- define the shape of a building in order to select or highlight it on the map
- the minimum number of polygons (polygons with holes) that cover the whole building top view
- the outlines that indicate which sides are actual building limits and which sides are tile borders
"buildings":[ { "id": "1597687598890565952",
"vertices": [ 256, 133.83, 256, 32.36, 186, 72.56, 224, 154.69 ],
"polygons": [ [ 0, 1, 2, 3]],
"outlines": [ [ 2, 1 ], [ 0, 3, 2 ]] } ]
The format is as follows: "id": "",
"vertices": [],
"polygons": [],
"outlines": []]
Name | Type | Description |
---|---|---|
id | String | Internal id of the building |
vertices | Array | Vertices (an array of x/y values, as in [ x1, y1, x2, y2 ... ] ) |
polygons | Array | Polygons (an array of polygons, each polygon being a set of indices of the vertices array) |
outlines | Array | Outlines (an array of outlines, each outline being a set of indices of the vertices array) |
Transit stops
"name": "",
"bounding boxes": [
"box 1": [],
"box 2": []
],
"info": [
{
"position": {
"latitude": ,
"longitude":
},
"official name": "",
"informal name": "",
"places id": "",
"operating hours": {
"Monday": [],
"Tuesday": [],
"Wednesday": [],
"Thursday": [],
"Friday": [],
"Saturday": [],
"Sunday": [],
"Holiday": []
},
"parking hours": {
"Monday": [],
"Tuesday": [],
"Wednesday": [],
"Thursday": [],
"Friday": [],
"Saturday": [],
"Sunday": [],
"Holiday": []
}
}
]
Name | Type | Description |
---|---|---|
name | String | Name of the transit stop |
bounding boxes | Bounding box | Array of bounding boxes (box 1 or box 2 or both) |
info | Transit Stop Info | Each transit stop info has:
Note: Parking information is provided for Transit Stations such as large Train and Bus Stations, so that users can have an entry level understanding of whether they may be able to Park & Ride at that location. The following cases are covered in the content:
|
POIs
The POIs field displays information about different POIs in the map including the name, geoposition, bounding boxes and an array of POI info objects. If you want to get information about POIs in the metainfo tile, you need to use the pois
parameter.
"name": "",
"geoposition": {
"latitude": ,
"longitude":
},
"bounding boxes": [],
"info": []
Name | Type | Description |
---|---|---|
name | String | Name of the POI |
geoposition | Geo Coordinate | Location of the POI |
bounding boxes | Bounding box | Array of bounding boxes (box 1 or box 2) |
info | Array of POI Info | Each POI info object can have the following attributes:
|
Field | Name | Type | Description |
---|---|---|---|
Bounding Box | left | Float | Location of the left coordinate in the tile |
top | Float | Location of the top coordinate in the tile | |
width | Float | Width of the bounding box | |
height | Float | Height of the bounding box | |
Geo coordinate | latitude | Float ( 6 decimals ) | Latitude of the geo coordinate |
longitude | Float ( 6 decimals ) | Longitude of the geo coordinate | |
City Center Info | type | String | Type of city between National Capital, Provincial Capital and Other |
name | String | Official name of the city | |
alternative names | Array of arrays | Alternative names of the city, each array containing the language code as String and the name as String | |
country code | String | Three letter country code following ISO | |
position | Geo coordinate | Location of the city center | |
population | Integer | Population of the city | |
Tile Coordinate | x | Integer | Coordinate x of the tile coordinate |
y | Integer | Coordinate y of the tile coordinate |
Two examples are provided in this section, both using mgen=2
, to illustrate the format described above. For additional information about how to use the mgen
parameter, see the Examples topic.
Berlin
and the request looks as follows: https://2.base.maps.ls.hereapi.com/maptile/2.1/maptile/newest/normal.day/9/275/167/256/png8
?apiKey={YOUR_API_KEY}
&metadata=metaonly
&mgen=2
{ "metadata" : {
"street labels":[ ],
"labels":[{ "name": "1", "type":"ROADSIGN", "bounding boxes": [ { "box 1":[ 94.62, 239.56, 18, 12 ] } ], "region": "DEU", "category": 1, "route name": "B1", "route level": 3, "uri": "http://image.maps.ls.hereapi.com.com/mia/1.6/roadsign?category=1®ion=DEU&label=B1&route_level=3&apiKey=%7BYOUR_API_KEY%7D" },
{ "name": "158", "type":"ROADSIGN", "bounding boxes": [ { "box 1":[ 166.38, 129.27, 22, 12 ] } ], "region": "DEU", "category": 1, "route name": "B158", "route level": 3, "uri": "http://image.maps.ls.hereapi.com.com/mia/1.6/roadsign?category=1®ion=DEU&label=B158&route_level=3&apiKey=%7BYOUR_API_KEY%7D" },
{ "name": "114", "type":"ROADSIGN", "bounding boxes": [ { "box 1":[ 13.38, 158.60, 23, 16 ] } ], "region": "DEU", "category": 0, "route name": "A114", "route level": 2, "uri": "http://image.maps.ls.hereapi.com.com/mia/1.6/roadsign?category=0®ion=DEU&label=A114&route_level=2&&apiKey=%7BYOUR_API_KEY%7D" },
{ "name": "11", "type":"ROADSIGN", "bounding boxes": [ { "box 1":[ 61.50, 166.63, 22, 16 ] } ], "region": "DEU", "category": 0, "route name": "A11", "route level": 2, "uri": "http://image.maps.ls.hereapi.com/mia/1.6/roadsign?category=0®ion=DEU&label=A11&route_level=2&apiKey=%7BYOUR_API_KEY%7D" },
{ "name": "2", "type":"ROADSIGN", "bounding boxes": [ { "box 1":[ 36.62, 188.59, 18, 12 ] } ], "region": "DEU", "category": 1, "route name": "B2", "route level": 3, "uri": "http://image.maps.ls.hereapi.com/mia/1.6/roadsign?category=1®ion=DEU&label=B2&route_level=3&apiKey=%7BYOUR_API_KEY%7D" },
{ "name": "109", "type":"ROADSIGN", "bounding boxes": [ { "box 1":[ 49.88, 28.25, 22, 12 ] } ], "region": "DEU", "category": 1, "route name": "B109", "route level": 3, "uri": "http://image.maps.ls.hereapi.com/mia/1.6/roadsign?category=1®ion=DEU&label=B109&route_level=3&apiKey=%7BYOUR_API_KEY%7D" }],
"city center labels":[{"name": "Berlin", "box 2":[ 9, 218, 49.45, 20.50 ], "box 1":[ 4, 234, 5, 5 ], "city center info": {"type":"NATIONAL CAPITAL", "name": "Berlin", "alternative names":[["ARA", "برلين"], ["BAQ", "Berlin"], ["BUL", "Берлин"], ["BUX", "Berlin"], ["CAT", "Berlín"], ["CHI", "柏林"], ["CHT", "柏林"], ["CZE", "Berlín"], ["CZX", "Berlin"], ["DAN", "Berlin"], ["DUT", "Berlijn"], ["ENG", "Berlin"], ["EST", "Berliin"], ["ESX", "Berliin"], ["FIN", "Berliini"], ["FRE", "Berlin"], ["GER", "Berlin"], ["GRE", "Βερολίνο"], ["GRX", "Verolino"], ["HIN", "बर्लिन"], ["HIX", "Barlin"], ["HUN", "Berlin"], ["HUX", "Berlin"], ["ICE", "Berlín"], ["IND", "Berlin"], ["ITA", "Berlino"], ["JPN", "ベルリン"], ["JPX", "Berurin"], ["KOR", "베를린"], ["KOX", "Be Reul Rin"], ["LAV", "Berlīne"], ["LAX", "Berline"], ["LIT", "Berlynas"], ["LIX", "Berlynas"], ["MAY", "Berlin"], ["NOR", "Berlin"], ["POL", "Berlin"], ["POR", "Berlim"], ["POX", "Berlin"], ["PYN", "Bo Lin"], ["RMX", "Berlin"], ["RUM", "Berlin"], ["RUS", "Берлин"], ["RUX", "Berlin"], ["SCR", "Berlin"], ["SLO", "Berlín"], ["SLX", "Berlin"], ["SPA", "Berlín"], ["SRX", "Berlin"], ["SWE", "Berlin"], ["THA", "เบอร์ลิน"], ["TUR", "Berlin"], ["TUX", "Berlin"], ["UKR", "Берлін"], ["UKX", "Berlin"]], "country code": "DEU", "position": {"latitude":52.514648, "longitude":13.375854}, "population": 3442675 } },
{"name": "Eberswalde", "box 2":[ 167, 36, 58.22, 11.75 ], "box 1":[ 165, 45, 2, 2 ], "city center info": {"type":"OTHER", "name": "Eberswalde", "alternative names":[], "country code": "DEU", "position": {"latitude":52.833252, "longitude":13.815308}, "population": 41175 } },
{"name": "Bernau bei Berlin", "box 2":[ 83, 117, 55.08, 22.75 ], "box 1":[ 81, 137, 2, 2 ], "city center info": {"type":"OTHER", "name": "Bernau bei Berlin", "alternative names":[], "country code": "DEU", "position": {"latitude":52.679443, "longitude":13.584595}, "population": 36154 } },
{"name": "Strausberg", "box 2":[ 191, 192, 51.91, 10.50 ], "box 1":[ 189, 200, 2, 2 ], "city center info": {"type":"OTHER", "name": "Strausberg", "alternative names":[], "country code": "DEU", "position": {"latitude":52.575073, "longitude":13.881226}, "population": 26221 } },
{"name": "Wandlitz", "box 2":[ 43, 83, 40.47, 10.50 ], "box 1":[ 41, 91, 2, 2 ], "city center info": {"type":"OTHER", "name": "Wandlitz", "alternative names":[], "country code": "DEU", "position": {"latitude":52.756348, "longitude":13.474731}, "population": 21530 } },
{"name": "Neuenhagen bei Berlin", "box 2":[ 121, 211, 58.64, 20.50 ], "box 1":[ 119, 229, 2, 2 ], "city center info": {"type":"OTHER", "name": "Neuenhagen bei Berlin", "alternative names":[], "country code": "DEU", "position": {"latitude":52.525635, "longitude":13.688965}, "population": 16755 } },
{"name": "Ahrensfelde", "box 2":[ 81, 192, 56.22, 10.50 ], "box 1":[ 79, 200, 2, 2 ], "city center info": {"type":"OTHER", "name": "Ahrensfelde", "alternative names":[], "country code": "DEU", "position": {"latitude":52.575073, "longitude":13.579102}, "population": 13114 } },
{"name": "Bad Freienwalde (Oder)", "box 2":[ 165.17, 56, 75.83, 20.50 ], "box 1":[ 241, 74, 2, 2 ], "city center info": {"type":"OTHER", "name": "Bad Freienwalde (Oder)", "alternative names":[], "country code": "DEU", "position": {"latitude":52.783813, "longitude":14.024048}, "population": 12964 } },
{"name": "Werneuchen", "box 2":[ 137, 159, 57.83, 10.50 ], "box 1":[ 135, 167, 2, 2 ], "city center info": {"type":"OTHER", "name": "Werneuchen", "alternative names":[], "country code": "DEU", "position": {"latitude":52.630005, "longitude":13.732910}, "population": 7943 } },
{"name": "Biesenthal", "box 2":[ 105, 76, 49.03, 10.50 ], "box 1":[ 103, 84, 2, 2 ], "city center info": {"type":"OTHER", "name": "Biesenthal", "alternative names":[], "country code": "DEU", "position": {"latitude":52.767334, "longitude":13.645020}, "population": 5563 } },
{"name": "Rehfelde", "box 2":[ 207, 218, 42.12, 10.50 ], "box 1":[ 205, 226, 2, 2 ], "city center info": {"type":"OTHER", "name": "Rehfelde", "alternative names":[], "country code": "DEU", "position": {"latitude":52.531128, "longitude":13.925171}, "population": 4462 } },
{"name": "Liebenwalde", "box 2":[ 15, 13, 57.72, 10.50 ], "box 1":[ 13, 21, 2, 2 ], "city center info": {"type":"OTHER", "name": "Liebenwalde", "alternative names":[], "country code": "DEU", "position": {"latitude":52.871704, "longitude":13.397827}, "population": 4390 } },
{"name": "Chorin", "box 2":[ 189, 0, 31.52, 10.50 ], "box 1":[ 187, 2, 2, 2 ], "city center info": {"type":"OTHER", "name": "Chorin", "alternative names":[], "country code": "DEU", "position": {"latitude":52.904663, "longitude":13.875732}, "population": 2430 } },
{"name": "Oderberg", "box 2":[ 203.75, 17, 45.25, 10.50 ], "box 1":[ 249, 25, 2, 2 ], "city center info": {"type":"OTHER", "name": "Oderberg", "alternative names":[], "country code": "DEU", "position": {"latitude":52.866211, "longitude":14.046021}, "population": 2229 } },
{"name": "Britz", "box 2":[ 139.81, 4, 23.19, 10.50 ], "box 1":[ 163, 12, 2, 2 ], "city center info": {"type":"OTHER", "name": "Britz", "alternative names":[], "country code": "DEU", "position": {"latitude":52.888184, "longitude":13.809814}, "population": 2201 } },
{"name": "Rüdnitz", "box 2":[ 99, 103, 36.39, 10.50 ], "box 1":[ 97, 111, 2, 2 ], "city center info": {"type":"OTHER", "name": "Rüdnitz", "alternative names":[], "country code": "DEU", "position": {"latitude":52.723389, "longitude":13.628540}, "population": 1839 } },
{"name": "Marienwerder", "box 2":[ 89, 30, 63.73, 10.50 ], "box 1":[ 87, 38, 2, 2 ], "city center info": {"type":"OTHER", "name": "Marienwerder", "alternative names":[], "country code": "DEU", "position": {"latitude":52.844238, "longitude":13.601074}, "population": 1731 } },
{"name": "Prötzel", "box 2":[ 210.95, 152, 34.09, 10.50 ], "box 1":[ 227, 164, 2, 2 ], "city center info": {"type":"OTHER", "name": "Prötzel", "alternative names":[], "country code": "DEU", "position": {"latitude":52.635498, "longitude":13.985596}, "population": 1143 } }],
"buildings":[ ],
"transit stops":[ ],
"POIs":[ ]
}
}
Berlin
including street labels. The request looks as follows: https://2.base.maps.ls.hereapi.com/maptile/2.1/maptile/newest/normal.day/13/4402/2685/256/png8
?apiKey={YOUR_API_KEY}
&metadata=metaonly
&mgen=2
{ "metadata" : {
"street labels":[ { "name":"Hansastraße", "font size":"11", "vertices": [ 163.53, 118.07, 175.55, 102.83, 178.97, 98.52, 183, 93.89, 187.21, 90.07, 190.71, 87, 194.13, 84.78, 210.95, 75.05 ] },
{ "name":"Weißenseer Weg", "font size":"11", "vertices": [ 147.10, 240.99, 172.97, 288.05, 176.50, 297.99, 182.69, 319.32 ] } ],
"labels":[{ "name": "Volkspark Prenzlauer Berg", "type":"TEXT", "bounding boxes": [ { "box 2":[ 64.67, 243, 55.03, 37.75 ] } ] },
{ "name": "Weißenseepark", "type":"TEXT", "bounding boxes": [ { "box 2":[ 55.70, 78.21, 77.97, 11.75 ] } ] },
{ "name": "Sportforum Hohenschönhausen", "type":"TEXT", "bounding boxes": [ { "box 1":[ 167.44, 215.11, 11, 11 ] } ] },
{ "name": "Sportkomplex Buschallee", "type":"TEXT", "bounding boxes": [ { "box 1":[ 237.81, 60.93, 11, 11 ] } ] },
{ "name": "Sportforum Hohenschönhausen", "type":"TEXT", "bounding boxes": [ { "box 2":[ 123.16, 190.11, 99.55, 23.75 ] } ] },
{ "name": "Sportkomplex Buschallee", "type":"TEXT", "bounding boxes": [ { "box 2":[ 207.53, 35.93, 71.56, 23.75 ] } ] }],
"city center labels":[{"name": "Alt-Hohenschönhausen", "box 1":[ 248.95, 133.43, 126.09, 29.50 ], "city center info": {"type":"OTHER", "name": "Alt-Hohenschönhausen", "alternative names":[], "country code": "DEU", "position": {"latitude":52.547607, "longitude":13.500824}, "population": 0 } },
{"name": "Weißensee", "box 1":[ 84.66, 8.86, 70.67, 15.50 ], "city center info": {"type":"OTHER", "name": "Weißensee", "alternative names":[], "country code": "DEU", "position": {"latitude":52.561340, "longitude":13.467865}, "population": 0 } }],
"buildings":[ ],
"transit stops":[ ],
"POIs":[ ]
}
}