HERE Map Tile v2 開発者ガイド

メタデータ Generation One のメタ情報タイル形式

各メタ情報タイルは、次の情報を JSON 構造体で表示し
  • メタデータ:レスポンスのコンテナ
    • 番地ラベル - 番地ラベルの配列
      • 名前
      • フォントサイズ
      • vertices - タイル座標の配列
        • X
        • Y
    • ラベル–ラベルの配列
      • 名前
      • タイプ
      • バウンディングボックス–ボックスの配列
        • 上( Top )
        • 高さ
    • 都市の中心部のラベル–都市の中心部のラベルの配列
      • 名前
      • テキストボックス
        • 上( Top )
        • 高さ
      • 箇条書きボックス
        • 上( Top )
        • 高さ
      • 市内中心部の情報
        • タイプ
        • 名前
        • 代替名–名前の配列
          • 国コード
          • 名前
        • 国コード
        • 位置
          • 緯度
          • 経度
        • 人口
ます。形式は次のとおりです。
{
  "metadata": {
    "street labels": [],
    "labels": [],
    "city center labels": []
  }
}

番地ラベル

[ 番地ラベル ] フィールドには、道路の名前、道路のレンダリングに使用されるフォントサイズ、およびバウンディング ボックスを表すポリラインを描画するための頂点の配列を含むラベルの配列が表示されます。 形式は次のとおりです。
"name": "",
"font size": "",
"vertices: [
  "x":,
  "y":
]
名前 タイプ 説明
名前 文字列 番地の名前
フォントサイズ 文字列 ラベルのレンダリングに使用されるフォントサイズ。文字列で表示される数値です
頂点 タイル座標の配列 番地ラベルにバウンディング ボックスを作成するポリラインを描画するために必要なすべての頂点を含む配列。

ラベル

ラベルフィールドには、名前、タイプ、場所(バウンディング ボックス)など、道路標識に関する情報のみが表示されます。 形式はラベルの配列で、各ラベルの形式は次のとおりです。
"name": "",
"type": "ROADSIGN",
"bounding boxes": []
名前 タイプ 説明
名前 文字列 ラベルに表示されている名前
タイプ 文字列 次のいずれかのタイプです。 道路標識
バウンディングボックス バウンディング ボックスの配列 ラベルのすべてのバウンディングボックスを含む配列

市区町村の中心のラベル

このフィールドには、都市の中心部のラベルの配列が表示されます。各ラベルには、名前の名前と位置(バウンディング ボックス)、区市町村の中心部と市の中心部の追加情報を示す小さな正方形である黒丸ボックスの位置(バウンディング ボックス)が含まれています。 都市の種類、公式に表示されている名前、別の言語で表示されている代替名、国コード、位置(緯度および経度)、および人口が表示されます。 形式は次のとおりです。
"name": "",
"text box" : {
  "left": ,
  "top": ,
  "width": ,
  "height":
},
"bullet box" : {
  "left": ,
  "top": ,
  "width": ,
  "height":
},
"city center info": {
  "type": "",
  "name": "",
  "alternative names": [
    [
      "",
      ""
    ]
  ],
  "country code": "",
  "position": {
    "latitude":,
    "longitude":
  },
  "population":
}
名前 タイプ 説明
名前 文字列 市区町村の名前
テキストボックス Bounding Box タイル内のラベルの場所
箇条書きボックス Bounding Box タイルの箇条書きの場所
市内中心部の情報 構造 都市の追加情報を含む構造体

共通のフィールド

フィールド 名前 タイプ 説明
Bounding Box 整数 タイル内の左座標の位置
上( Top ) 整数 タイル内の上部座標の位置
整数 バウンディング ボックスの幅
高さ 整数 バウンディング ボックスの高さ
地理座標 緯度 浮動小数点数 ( 小数点数 6 桁 ) ジオ座標の緯度
経度 浮動小数点数 ( 小数点数 6 桁 ) ジオ座標の経度
市街地中心部の情報 タイプ 文字列 首都と首都、その他の都市の間の都市のタイプ
名前 文字列 市区町村の正式な名前
代替の名前 配列の配列 都市の代替名。国コードが String 、名前が String である各配列
国コード 文字列 MARC コードの後に 3 文字の国コード
位置 地理座標 市内中心部のロケーション
人口 整数 都市の人口
タイルの座標 X 整数 タイル座標の座標 x
Y 整数 タイル座標の y 座標

このセクションでは mgen=1、上記の形式を説明するために、 2 つの例を使用しています。 mgen パラメーターの使用方法の詳細については、のトピックを参照してください。

注 : これらの 2 つの例で は、 HERE API キー を使用 してリクエストを認証します。 使用可能な認証オプションについて は、『 Identity & Access Management 開発者ガイド』を参照してください。
最初の例では、のパラメータ 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=1
応答は次のようになります。
{ "metadata" : {
"street labels":[

],
"labels":[
  {"name":"1", "type": "ROADSIGN", "bounding boxes": [ { "left":96, "top":240, "width":18, "height":12 } ] },
   ...,
  {"name":"109", "type": "ROADSIGN", "bounding boxes": [ { "left":49, "top":28, "width":22, "height":12 } ] }
],
"city center labels":[
  {"name": "Berlin", "text box": { "left":9, "top":218, "width":49.45, "height":20.50 }, "bullet box": { "left":4, "top":234, "width":5, "height":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": "Prötzel", "text box": { "left":210, "top":152, "width":34.09, "height":10.50 }, "bullet box": { "left":227, "top":164, "width":2, "height":2 }, "city center info": {"type":"OTHER", "name": "Prötzel", "alternative names":[], "country code": "DEU", "position": {"latitude":52.635498, "longitude":13.985595}, "population": 1143 } }
]
}
}
もう Berlin 1 つの例には、番地ラベルを含む位置情報のクローズアップに対するメタデータ応答が含まれています。 リクエストの内容は次のとおりです。
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=1
応答は次のようになります。
{ "metadata" : {
"street labels":[
{ "name":"Hansastraße", "font size":"11", "vertices": [ { "x": 163, "y": 118 },  { "x": 175, "y": 102 },  { "x": 178, "y": 98 },  { "x": 182, "y": 93 },  { "x": 187, "y": 90 },  { "x": 190, "y": 87 },  { "x": 194, "y": 84 },  { "x": 210, "y": 75 } ] },
{ "name":"Weißenseer Weg", "font size":"11", "vertices": [ { "x": 147, "y": 240 },  { "x": 172, "y": 288 },  { "x": 176, "y": 297 },  { "x": 182, "y": 319 } ] }
],
"labels":[
{"name":"Volkspark Prenzlauer Berg", "type": "TEXT", "bounding boxes": [ { "left":64, "top":243, "width":55.03, "height":37.75 } ] },
{"name":"Weißenseepark", "type": "TEXT", "bounding boxes": [ { "left":55, "top":78, "width":77.97, "height":11.75 } ] },
{"name":"Sportforum Hohenschönhausen", "type": "TEXT", "bounding boxes": [ { "left":167, "top":215, "width":11, "height":11 } ] },
{"name":"Sportkomplex Buschallee", "type": "TEXT", "bounding boxes": [ { "left":237, "top":61, "width":11, "height":11 } ] },
{"name":"Sportforum Hohenschönhausen", "type": "TEXT", "bounding boxes": [ { "left":123, "top":190, "width":99.55, "height":23.75 } ] },
{"name":"Sportkomplex Buschallee", "type": "TEXT", "bounding boxes": [ { "left":207, "top":36, "width":71.56, "height":23.75 } ] }
],
"city center labels":[
{"name": "Alt-Hohenschönhausen", "text box": { "left":248, "top":133, "width":126.09, "height":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", "text box": { "left":84, "top":8, "width":70.67, "height":15.50 }, "city center info": {"type":"OTHER", "name": "Weißensee", "alternative names":[], "country code": "DEU", "position": {"latitude":52.561340, "longitude":13.467865}, "population": 0 } }
]
}
}