ラベル付きメタ情報
ユーザーが、マップのラベルをインタラクティブにして提供したいと考えています。たとえば、マップに追加情報を表示させるいくつかのオプションがあります。 これを行うには、さまざまな種類のラベルを含むマップ タイルを表示しているイメージに関するメタデータ情報を取得する必要があります。
山の山のピークのラベルの要求
最初のリクエストでは、山のピークラベル 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}
山岳地帯のピークラベルの対応
この応答では、次のイメージが提供されます。
歩行者ポイントラベルのリクエスト
このリクエストで 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}
歩行者ポイントラベルの応答
リクエストに対する応答では、次のイメージが提供されます。
次のコードブロックは、メタデータマップ タイルに対する完全なリクエストを示しています。
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
属性を使用してラベルタイプを指定するlabels
metadata
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 つのラベル () の表現のみが含まれています。