HERE Map Tile v2 開発者ガイド

メタ情報と POIs

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

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

元のマップ タイル

このリクエストは、マップ タイルと POI を取得します。

https://2.base.maps.ls.hereapi.com/maptile/2.1/maptile/newest/normal.day/19/281563/171971/256/png8
?apiKey={YOUR_API_KEY}
&pois

応答には、次の POI が含まれています : Zoological Garden in Berlin

図 1. マップ タイルと POI

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

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

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

https://2.base.maps.ls.hereapi.com/maptile/2.1/maptile/newest/normal.day/19/281563/171971/256/png8
?apiKey={YOUR_API_KEY}
&metadata=metaonly
&mgen=2
&pois

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

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

{
  "metadata": {
    "street labels":[ ... ],
    "labels":[ ... ],
    "city center labels":[],
    "buildings":[  ],
    "transit stops":[  ],
    "POIs":[
      {  
        "name":"Zoological Garden",
        "geoposition":{"latitude":52.508211, "longitude":13.334570},
        "bounding boxes":[
          {
            "box 1":[ 217, 35.75, 14, 14 ]
          }, 
          {
            "box 2":[ 199.86, 13.75, 48.28, 20.50 ]
          }
        ],
        "info":[
          {
            "PLACE NAME":"Zoological Garden",
            "PLACE PHONE NUMBER":"+(49)-30-254010",
            "PLACE CATEGORY":"Tourist Attraction",
            "PLACE ID":"50668488"
          }
        ]
      }
    ]
  }
}
  

この情報を使用すると、 POI をインタラクティブにするために、 POI のアイコンとラベルを見つけることができます。 この場合 、bounding boxes配列の要素を使用でき ます。box 1は、アイコンのバウンディング ボックスについて説明し、box 2はテキストラベルのバウンディング ボックスについて説明しています。

geoposition メタ情報 JSON オブジェクトのオブジェクトは、 POI のジオコード化を提供します。 これらのアドレスを使用して、例えばリバースジオ コーディングのように POI のアドレスを取得できます。
http://reverse.geocoder.cit.api.here.com/6.2/reversegeocode.xml
?apiKey={YOUR_API_KEY}
&gen=7
&prox=52.508211135864258,13.334569931030273,100
&mode=retrieveAddresses
<Address>
<Label>Hardenbergplatz, 10623 Berlin, Deutschland</Label>
<Country>DEU</Country>
<State>Berlin</State>
<County>Berlin</County>
<City>Berlin</City>
<District>Charlottenburg</District>
<Street>Hardenbergplatz</Street>
<PostalCode>10623</PostalCode>
<AdditionalData key="CountryName">Deutschland</AdditionalData>
<AdditionalData key="StateName">Berlin</AdditionalData>
</Address>
POI に関連する追加情報を表示できます(情報バブルなどを使用)。 この情報は info 、 JSON オブジェクトによって提供されます。
  • name (PLACE NAME 属性 )
  • カテゴリ (PLACE CATEGORY 属性 )
  • 電話番号 (PLACE PHONE NUMBER 属性 )
  • place id (PLACE ID 属性 )