メタ情報には都市部のラベルが貼られています
ユーザーが、画像に関するメタデータを取得しようとしています。たとえば、都市の中心のラベルを含むマップ タイルを表示して、それらのラベルをインタラクティブに表示したり、地図に表示する追加情報を選択するオプションを提供したりします。
注 : これらの例 では、 HERE API キー を使用して要求を認証します。 使用可能な認証オプションについて は、『 Identity & Access Management 開発者ガイド』を参照してください。
元のマップ タイル
このリクエストでは、目的の都市の中心部のラベルが付いたマップ タイルを取得します。
https://2.base.maps.ls.hereapi.com/maptile/2.1/maptile/newest/normal.day/5/5/10/256/png8
?apiKey={YOUR_API_KEY}応答には次のイメージが含まれています。
このタイルには、以下の都市の中心部のラベルが含まれています Calgary, Edmonton, Vancouver 以下のリクエストは、これらの各ラベルのメタデータを取得します。
メタ情報タイルリクエスト
この要求では、クエリ パラメーター metadata が応答にメタデータのみを含めることを指定し、クエリ パラメーター mgen が応答に含めるメタ情報を指定します。
https://2.base.maps.ls.hereapi.com/maptile/2.1/maptile/newest/normal.day/5/5/10/256/png8
?apiKey={YOUR_API_KEY}
&metadata=metaonly
&mgen=2メタ情報タイル応答を処理しています
リクエストに対する応答では、次のメタ情報タイルが JSON オブジェクトとして提供されます。
{
"metadata": {
"street labels":[ ],
"labels":[ ... ],
"city center labels":[
{
"name": "Calgary",
"box 2":[ 165.64, 165, 52.36, 16.75 ],
"box 1":[ 218, 178, 5, 5 ],
"city center info": {
"type":"OTHER",
"name": "Calgary",
"alternative names":[],
"country code": "CAN",
"position": {"latitude":51.064453, "longitude":-114.082031}, "population": 1096830 }
},
... ],
"buildings":[ ],
"transit stops":[ ],
"POIs":[ ]
}
} 注 : レスポンスの一部は 、 Examples の概要で説明 されているように変更され、関連する都市部のデータのみが表示されます。
この情報を使用 すると、都市の中心にあるアイコンとラベルを見つけてインタラクティブにすることができます。box 1では、アイコンのバウンディング ボックスとテキストラベルのバウンディング ボックスをbox 2指定します。
都市の中心のアイコンは、都市の種類によって異なる場合があります。
city center info JSON オブジェクトのtype属性で指定された都市タイプに関する情報は、次のとおりです。 - 国の首都
- 州都
- その他
ラベルが複数の言語にローカライズされている場合 ( 例 : 上記のコード例のEdmontonラベル ) 、city center info JSON オブジェクトのalternative names オブジェクトでは、相対的な情報が指定されます。
country code およびなどの追加情報 population を情報バブルなどで表示できます。
city center JSON オブジェクトのposition属性は、都市の地理的座標を指定します。
