HERE Map Tile v2 開発者ガイド

メタデータ生成パラメータ

ユーザーが Friedenau in Berlin, Germany 、インタラクティブ機能を有効にするためのラベルの位置を把握するために、近隣の領域のマップ タイルを示す画像のメタデータ情報を取得しようとしています。

注 : mgen パラメータを使用して、 2 つの可能なメタ情報要求を例として示します。 メタ情報タイルリクエストの詳細について は、「メタ情報タイル」も参照してください。
注 : これらの例 では、 HERE API キー を使用して要求を認証します。 使用可能な認証オプションについて は、『 Identity & Access Management 開発者ガイド』を参照してください。

元のマップ タイル

ユーザーが詳細情報を検索するタイルは、次のリクエストによって取得されます。

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

リクエストに対する応答では、次のイメージが提供されます。

図 1. マップ タイル

メタデータのみを使用してリクエストします

以下のコードブロックは、メタデータマップ タイルに対する完全なリクエストを示しています。

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
注 : 応答の一部が 、例の概要で説明されているように変更されました。

メタデータのみで応答します

リクエストに対する応答では、次のメタ情報タイルが JSON オブジェクトとして提供されます。


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

MGEN=2 でリクエストします

この要求では、パラメータ mgen によって、応答がメタデータマップ タイルを使用することが指定されます。 これは、テキストベースの( JSON )タイルで、番地ラベル、市区町村ラベル、アイコンなどの関連するオブジェクトが含まれています。 これらの各オブジェクトには、などの特定のプロパティがあります
  • バウンディングボックスを使用した配置
  • 緯度および経度
  • 道路標識など、アイコン情報が表示された道路アイコン
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

MGEN=2 で応答しました

リクエストに対する応答では、次のメタ情報タイルが JSON オブジェクトとして提供されます。


      
      {
  "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": []
  }
}
      
注 : 応答の一部は 、例の概要で説明されているように変更されます。