HERE Map Tile v2 開発者ガイド

道路標識のあるメタ情報

ユーザーが地図上の道路標識をインタラクティブにして、地図に追加情報を表示するオプションなどを提供したいと考えています。 これを行うには、道路標識を含むマップ タイルを示す画像についてのメタデータ情報を取得する必要があります。

注 : これらの例 では、 HERE API キー を使用して要求を認証します。 使用可能な認証オプションについて は、『 Identity & Access Management 開発者ガイド』を参照してください。

元のマップ タイル

このリクエストは、道路標識のあるマップ タイルを取得します。

https://2.base.maps.ls.hereapi.com/maptile/2.1/maptile/newest/normal.day/13/4410/2694/256/png8
?apiKey={YOUR_API_KEY}

応答には、ルートの道路標識 A12 in Germanyが含まれています。

図 1. 道路標識があるマップ タイル

次のリクエストは、このマップ タイルに関する詳細情報を取得します。

メタ情報タイルリクエスト

この要求では、クエリ パラメーター metadata が応答にメタデータのみを含めることを指定し、クエリ パラメーター mgen が応答に含めるメタ情報を指定します。

https://2.base.maps.ls.hereapi.com/maptile/2.1/maptile/newest/normal.day/13/4410/2694/256/png8
?apiKey={YOUR_API_KEY}
&metadata=metaonly
&mgen=2

メタ情報タイル応答を処理しています

応答には、道路標識を見つけてインタラクティブにするための情報が含まれています。

道路標識のラベルは labels 、メタデータ JSON オブジェクトの配列に属し"type": "ROADSIGN"ています () 。 box 1 この配列では、道路標識アイコンのバウンディング ボックスが [x, y, width, height] の形式で指定されます。

また、 JSON オブジェクトには、次の情報も含まれています。

  • 国の地域
  • 道路標識のカテゴリー
  • ルート名
  • ルートレベル
{
  "metadata": {
    "street labels": [],
    "labels": [
      {
        "name": "12",
        "type": "ROADSIGN",
        "bounding boxes": [ { "box 1":[ 41.62, 71.52, 24, 18 ] } ],
        "region": "DEU",
        "category": 0,
        "route name": "A12",
        "route level": 2,
        "uri": "http://image.maps.ls.hereapi.com/mia/1.6/roadsign?category=0&region=DEU&label=A12&route_level=2&apiKey={YOUR_API_KEY}"
      }
    ],
    "city center labels":[],
    "buildings": [],
    "transit stops": [],
    "POIs": []
  }
}

uri リクエストとして、上記のレスポンス本文の属性の値を使用して、関連する道路標識アイコンを取得します。

http://image.maps.ls.hereapi.com/mia/1.6/roadsign
?category=0
&region=DEU
&label=A12
&route_level=2
&apiKey={YOUR_API_KEY}
図 2. 道路標識アイコン

道路標識用にメタ情報のみをフィルタリングします

filter リクエストにパラメータを追加すると、道路標識ラベルのメタ情報のみが取得され、その他のすべての種類のラベルが JSON 応答から除外されます。 これは、以下に要求されているさまざまなラベルが含まれているタイルの場合に役立ちます。

https://2.base.maps.ls.hereapi.com/maptile/2.1/maptile/newest/normal.day/11/1102/673/256/png8
?apiKey={YOUR_API_KEY}
この応答では、多くの都市の中心部のラベルを含むタイルが提供されます。
図 3. 複数のラベルがあるタイル

リクエストにが指定されている場合 "filter=1"、メタデータタイルの道路標識ラベルのみが取得されます。

https://2.base.maps.ls.hereapi.com/maptile/2.1/maptile/newest/normal.day/11/1102/673/256/png8
?apiKey={YOUR_API_KEY}
&metadata=metaonly
&mgen=2
&filter=1

応答には、道路標識ラベルに関連する情報のみが含まれています。

{
  "metadata": {
    "labels": [
      {
        "name": "12",
        "type":"ROADSIGN",
        "bounding boxes": [ { "box 1":[ 46.38, 110.68, 22, 16 ] } ],
        "region": "DEU",
        "category": 0,
        "route name": "A12",
        "route level": 2,
        "uri": "http://image.maps.ls.hereapi.com/mia/1.6/roadsign?category=0&region=DEU&label=A12&route_level=2&apiKey={YOUR_API_KEY}"
       },
      {  
        "name": "10",
        "type":"ROADSIGN",
        "bounding boxes": [ { "box 1":[ 7, 115.18, 22, 16 ] } ],
        "region": "DEU",
        "category": 0,
        "route name": "A10",
        "route level": 2,
        "uri": "http://image.maps.ls.hereapi.com/mia/1.6/roadsign?category=0&region=DEU&label=A10&route_level=2&apiKey={YOUR_API_KEY}"
      }
    ]
  }
}