HERE Map Tile v2 開発者ガイド

ラベル付きメタ情報

ユーザーが、マップのラベルをインタラクティブにして提供したいと考えています。たとえば、マップに追加情報を表示させるいくつかのオプションがあります。 これを行うには、さまざまな種類のラベルを含むマップ タイルを表示しているイメージに関するメタデータ情報を取得する必要があります。

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

山の山のピークのラベルの要求

最初のリクエストでは、山のピークラベル Vesuvius Volcano in Italyが次のようなタイルが取得されます。

https://2.base.maps.ls.hereapi.com/maptile/2.1/maptile/newest/normal.day/17/70789/49227/256/png8
?apiKey={YOUR_API_KEY}

山岳地帯のピークラベルの対応

この応答では、次のイメージが提供されます。

図 1. 山の頂上のラベルが付いているマップ タイル

歩行者ポイントラベルのリクエスト

このリクエストで pedestrian.day は、このスキームは以下の場所に歩行者ポイントのラベルを取得 Kievします。

https://2.base.maps.ls.hereapi.com/maptile/2.1/maptile/newest/pedestrian.day/19/306646/176817/256/png8
?apiKey={YOUR_API_KEY}

歩行者ポイントラベルの応答

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

図 2. マップ タイルと歩行者専用道路のラベル

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

https://2.base.maps.ls.hereapi.com/maptile/2.1/maptile/newest/pedestrian.day/19/306646/176817/256/png8
?apiKey={YOUR_API_KEY}
&metadata=metaonly
&mgen=2

未分類のラベル

他の種類のラベルを持つマップタイル上のオブジェクトは、次のようになります。

  • 土地利用施設(公園)
  • 水力ラベル ( 海、海、川、湖 )
  • 国または大陸の名前

ラベルタイプとアイコン

クエリーパラメータmetadataおよびmgenを 上記のリクエストに追加すると、ラベルをインタラクティブにするために必要な情報が取得されます。

応答は 、 type属性を使用してラベルタイプを指定するlabelsmetadata JSON オブジェクトです ( 次のコード例の山のピークラベルMOUNTAIN_PEAKの場合 ) 。 形式[x, y, width, height]のラベルアイコンのbox 1配列 は、アイコンのバウンディング ボックスを表します。 box 2 は、テキストラベルのバウンディング ボックスを同じ形式で表します。

{
  "metadata": {
    "street labels": [],
    "labels": [
      {
        "name": "Mount Vesuvius",
        "type": "MOUNTAIN_PEAK",
        "bounding boxes": [
          {
            "box 1":[ 106, 226.80, 10, 10 ]
          }, 
          { 
            "box 2":[ 90, 195.80, 41.53, 31 ] 
          }
        ],
    "city center labels": [],
    "buildings": [],
    "transit stops": [],
    "POIs": []
  }
}
  
注 : type この属性では、徒歩ラベル () およびPEDESTRIAN_POINT未分類のラベル () も指定TEXTされます。 ただし、徒歩ラベルにはテキストラベルがなく、未分類のラベルにはアイコンがないため、 label にはbox 1、これらのラベルタイプの 1 つのラベル () の表現のみが含まれています。