第 2 世代メタデータのメタ情報タイル形式

各メタ情報タイルは、 JSON 構造体に次の情報を表示します。

• メタデータ：レスポンスのコンテナ
  • 番地ラベル–番地ラベルの配列
    • 名前
    • フォントサイズ
    • vertices - タイル座標の配列
  • ラベル–ラベルの配列
    • 名前
    • タイプ
    • バウンディングボックス–ボックスの配列
  • City center labels - 市内中心部のラベルの配列
    • 名前
    • ボックス 1
    • ボックス 2
    • 市内中心部の情報
      • タイプ
      • 名前
      • 代替名–名前の配列
        • 国コード
        • 名前
      • 国コード
      • 位置
        • 緯度
        • 経度
      • 人口
  • 建物–建物の配列
    • ID
    • vertices –頂点の配列
    • polygons –多角形の配列
    • アウトライン–アウトラインの配列
  • トランジットストップ–トランジットストップの配列
    • 名前
    • バウンディングボックス–バウンディングボックスの配列
      • ボックス 1
      • ボックス 2
    • 情報–配達地点情報の配列
      • 地理位置
        • 緯度
        • 経度
      • 正式な名前
      • 非公式の名前
      • 場所 ID
      • 営業時間
        • 月曜日
        • 火曜日
        • 水曜日
        • 木曜日
        • 金曜日
        • 土曜日
        • 日曜日
        • Holiday
      • 駐車場もある
        • 月曜日
        • 火曜日
        • 水曜日
        • 木曜日
        • 金曜日
        • 土曜日
        • 日曜日
        • Holiday
  • POI –ジャンル別施設（ POI ）の配列
    • 名前
    • 地理位置
      • 緯度
      • 経度
    • バウンディングボックス–バウンディングボックスの配列
      • ボックス 1
      • ボックス 2
    • 情報 - POI 情報の配列

形式は次のとおりです。

{
  "metadata": {
    "street labels": [],
    "labels": [],
    "city center labels": [],
    "buildings": [],
    "transit stops": [],
    "POIs": []
  }
}

[ 番地ラベル ] フィールドには、道路の名前、道路のレンダリングに使用されるフォントサイズ、およびバウンディング ボックスを表すポリラインを描画するための頂点の配列を含むラベルの配列が表示されます。 形式は次のとおりです。

"name": "",
"font size": "",
"vertices: []

[ ラベル ] フィールドには、名前、タイプ、場所（バウンディング ボックス）など、番地ラベルではないラベルに関する情報が表示されます。 形式はラベルの配列で、各ラベルの形式は次のとおりです。

"name": "",
"type": "",
"bounding boxes": []

このフィールドには、都市の中心部のラベルの配列が表示されます。各ラベルには、名前の名前と場所（バウンディング ボックス）、市の中心部の追加情報が含まれます。この情報には、都市のタイプ、公式に表示された名前、別の言語で表示された代替名、国コード、位置（緯度および経度）、および人口が表示されます。 形式は次のとおりです。

"name": "",
"box 1" : [],
"box 2": [],
"city center info": {
  "type": "",
  "name": "",
  "alternative names": [
    [
      "",
      ""
    ]
  ],
  "country code": "",
  "position": {
    "latitude":,
    "longitude":
  },
  "population":
}

Buildings フィールドには、現在のタイルの建物のリストが含まれています。 提供された情報によって、次のことが可能になります

• 建物の一意の ID を使用して、 1 つのタイル内または複数のタイルにわたる建物を識別します
• 建物を選択または地図で強調表示するために、建物の形状を定義します

建物のシェイプは、頂点、多角形、およびアウトラインの配列として提供されます。この配列では、多角形が内側か外側かを決定する巻線ロジックがポリゴンに反映されます。 建物ごとに、次の情報を利用できます。

• 建物の上面図全体をカバーするポリゴン ( 穴のあるポリゴン ) の最小数
• どの辺が実際の建物の境界で、どの辺がタイルの境界であるかを示すアウトライン

例 :

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

形式は次のとおりです。

"id": "",
"vertices": [],
"polygons": [],
"outlines": []]

中継地点フィールドには、名前、バウンディングボックス、および関連情報が表示されます。 形式は次のとおりです。

"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": "",
"geoposition": {
  "latitude": ,
  "longitude":
},
"bounding boxes": [],
"info": []

共通のフィールド

最初の例では、のパラメータ Berlin が表示され、要求は次のようになります。

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&region=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&region=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&region=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&region=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&region=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&region=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 では、番地ラベルを含む位置のクローズアップに対するメタデータ応答が含まれています。 リクエストの内容は次のとおりです。

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