場所レイヤー

HERE Vector Tile APIのplacesレイヤーには、国、地域、都市などの行政名のフィーチャーと、pointジオメトリータイプとして国内の州や省などの他のラベルが含まれています。このレイヤーには、近隣地域および都市内の地区の名前も表示されます。

places レイヤーには、行政区分名前に加えて、地域タイプ (国、州、省など)、人口、面積、その他の関連情報などのフィーチャーが含まれています。このデータを使用して、人口統計の傾向の調査ツール、選挙結果の視覚化ツール、経済データの分析ツールなど、高度なアプリケーションを作成できます。

次の図は、データからレンダリングされた places レイヤーのフィーチャーのサンプルを示しています。

レイヤーのコンテンツの定義は次のとおりです。

レイヤー名：places
ジオメトリータイプ：point

共有プロパティ

placesレイヤーのすべてのフィーチャーには、そのフィーチャーが表す特定のタイプの場所に関わらず、そのフィーチャーを定義する一連のプロパティが含まれています。

📘
注
これらのプロパティは、Tilezen スキーマでは common プロパティと呼ばれます。詳細については、「タイルレイヤー」を参照してください。

name - 場所の名前。使用可能なデータによっては、名前が複数の言語で提供される場合もあります。
name:latin - 場所のラテン名は、対応するラテン語名、ラテン語系言語の名前、またはその音訳の場合があります。ラテン名を使用できない場合、ラテン語系言語への置換名が最初に使用可能なラテン言語として選択されます。言語は次の順序で選択されます：("en"、"es"、"fr"、"pt"、"de"、"tr"、"it"、"pl"、"nl"、"ro"、"HU"、"cs"、"sv"、"sq"、"af"、"da"、"no"、"fi"、"sk"、"hr"、"sl"、"lv"、"lt"、"et"、"mt"、 "ga","cy","lb","is","fo")
id - placesフィーチャーの一意の識別子。
kind - 場所の一般的なタイプ。詳細については、「Kind の定義と例」を参照してください。
min_zoom - places フィーチャーを表示するための推奨最小ズームレベル。

条件プロパティ

一部のplacesフィーチャーには、対応するkindにのみ固有のプロパティが含まれています。

📘
注
これらのプロパティは、Tilezen スキーマでは common-optional プロパティと呼ばれます。詳細については、「タイルレイヤー」を参照してください。

country_capital - このプロパティは国の首都の場合trueとなり、kind値がlocalityであるフィーチャーにのみ適用されます。
region_capital - このプロパティは州都の場合 true となり、kind 値が locality であるフィーチャーにのみ適用されます。
county_capital - このプロパティは郡都の場合 true となり、kind 値が locality であるフィーチャーにのみ適用されます。
kind_detail - このプロパティは、特定の区域タイプや地域タイプなど、場所の kind について追加の詳細情報を提供します。kind_detail の値には、state、province、municipality、neighborhood などがあります。詳細については、「さまざま Kind カテゴリーの追加情報」を参照してください。
population - このプロパティには場所の人口 (整数値) が含まれ、kind 値が locality のフィーチャーにのみ適用されます。
iso_code - このプロパティには、ISO 3166-1 alpha-2の2文字の国コードが含まれています。countryのkind値を持つフィーチャーにのみ適用されます。
area_rank - このプロパティは、関連する国の面積を表す整数値を保持します。このプロパティは、kindの値がcountryのフィーチャーにのみ適用されます。
supercity - このプロパティは、すべてのズームレベルで常に表示されることが推奨される重要な都市の場合、trueになります。このプロパティは、値が false の場合は存在しません。
kind:xx - ある国の地政学的見解に従った kind の代替。xx には小文字の ISO 3166-1 alpha-2 コード (cy や tr など) が入ります。特定の見解に従ってフィーチャーを表示する場合は kind:xx を使用します。特定の見解が存在しない場合は kind を使用します。

以下は、異なる見解に基づくキプロスのラベルのコード例です。

インターナショナルビュー：

kind: country
kind:cy: unrecognized_country

キプロスビュー：

kind:cy	country

次の図は、地図にレンダリングされた places フィーチャーのサンプルと、関連付けられているメタデータを示しています。

Kind の定義と例

kind パラメーターは、一般的な場所のタイプ (国、地域、区域など) を表わしており、places フィーチャーのさまざまなタイプの背景情報を分類して区別するのに使用できます。これは、さまざまな詳細レベルや細分度を必要とするアプリケーションを構築する場合に役立ちます。

country - この値は、国全体を表すフィーチャーに使用されます。たとえば、米国、カナダ、メキシコなどがあります。
region - この値は、国内の広い地域、州、省を表すフィーチャーに使用されます。たとえば、米国のカリフォルニア州、ニューヨーク州、テキサス州、カナダのオンタリオ、ケベック、ブリティッシュコロンビアなどがあります。
locality - この値は、都市、町などの人口密集地域を表すフィーチャーに使用されます。たとえば、米国のニューヨーク市、ロサンゼルス、シカゴ、カナダのトロント、モントリオール、バンクーバーなどがあります。
borough - この値は、市区町村や他の区域内の小規模な行政区画を表すフィーチャーに使用されます。たとえば、ロンドンのソーホーやウォータールー、トロントのスカーバローやノースヨークなどがあります。
neighbourhood - この値は、市区町村や他の区域内の特定の近隣地域や地区を表すフィーチャーに使用されます。たとえば、ニューヨーク市のソーホーやバンクーバーのキツラノなどがあります。

日本固有の Kind の定義

以下の kind 値は、core マップの日本地図で使用できます。これらのパラメーターは日本国内の固有の行政単位を分類するために使用され、他の国や地域は対象外です。

これらの値を使用して、番地、地番、小区域など、日本のさまざまなタイプの行政単位を分類します。これは、これらの行政単位に関する特定の情報を必要とするアプリケーションを構築する場合に役立ちます。

HERE Vector Tile APIで使用可能な地図パラメーターの詳細については、「地図パラメーター」を参照してください。

以下の日本のcore地図パラメーターのkind値の一覧を参照してください。

aza - 番地や小集落など、区域内の行政単位を指します。日本で「aza (字)」は小さい行政区画を指す言葉として用いられます。
microhood - 番地や地番など、区域内の行政単位を指します。
oaza - より大きな区域内の小区域を指します。通常は、日本で都市部以外の地域を指すために使用されます。

次の図は、日本固有の kind 値を持つ places フィーチャーのサンプルを示しています。

さまざま Kind カテゴリーの追加情報

kind_detail 値は、場所のタイプ (特に locality、region、microhood kind) についての詳細情報を提供します。 locality kind のフィーチャーは、kind_detail プロパティに次のような値を指定できます。

city - 人口が 100,000 人以上の場所。
town - 人口が 10,001 人以上 100,000 人までの場所。
village - 人口が 201 人以上 10,000 人までの場所。
hamlet - 人口が 200 人以下の場所または hamlet ソースデータサブタイプの場所。
locality - 人口がなく、ラベルタイプのデータヒントがない場所。

次の図は、地図にレンダリングされた locality タイプの places フィーチャーのサンプルを示しています。

region kind のフィーチャーは、kind_detail プロパティに次のような値を指定できます。

state - 州レベルの地域。
province - 省レベルの地域。

microhood kind のフィーチャー (日本の core 地図パラメーターでのみ使用可能) の場合、kind_detail プロパティに次のような値を指定できます。

block - 番地。住所を特定するには住居番号が必要です。
parcel - 番地。住所を特定するために住居番号を必要としません。

次のステップ

HERE Vector Tile APIで使用できる他のレイヤーフィーチャータイプの詳細については、「タイルレイヤー」を参照してください。