Places

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

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

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

レイヤーの内容には、次の定義があります。

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

次のセクションで places は、 HERE Vector Tile API のレイヤーの概要について説明します。

• 共有プロパティ
• 条件付きプロパティ
• Kindの定義と例
  • 日本固有のKindの定義
• さまざまKindのカテゴリの追加情報
• 次のステップ

共有プロパティ

レイヤー内のすべてのフィーチャーには、そのレイヤーplaces が表す特定の場所の種類に関係なく、レイヤーを定義する一連のプロパティが含まれています。

• name - 場所の名前。 使用可能なデータに応じて、名前が複数の言語で提供される場合があります。
• id - places フィーチャーの一意の識別子。
• kind - 一般的Placesの種類。 詳細について は、「Kindの定義と例」を参照してください。
• min_zoom - このフィーチャーplaces を表示するために必要な最小推奨ズーム レベル。

条件付きプロパティ

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

• country_capital - このプロパティ true は国の首都に対応 しており、localityのkind値を持つフィーチャーにのみ適用されます。
• region_capital - このプロパティ true は州の大文字を使用するため のもので、localityのkind値を持つフィーチャにのみ適用されます。
• county_capital - このプロパティtrueは国の首都用 で、localityのkind値を持つフィーチャーにのみ適用されます。
• kind_detail - このプロパティでは、特定の地域タイプや地域など、そのPlaceskindに関する追加の詳細情報を提供します。 たとえば state、 province、 municipality、 neighborhoodなどの値kind_detail があります。 詳細 については、さまざまな種類のカテゴリの追加情報を参照してください。
• population - このプロパティには、整数値で表された場所の人口が含ま れ、localityのkind値を持つフィーチャにのみ適用されます。
• iso_code - このプロパティには 、 ISO 3166-1 のアルファ -2 文字の国コードが含ま れており、countryのkind値を持つフィーチャーにのみ適用されます。
• 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 - この値は、都市内の特定の近隣または地区、またはその他の地域を表すフィーチャーに使用されます。 たとえば、ニューヨーク市の SoHo やバンクーバーの Kitsilano などです。

日本固有のKindの定義

日本マップkindでは、マップ レイヤー core内で次の値を使用できます。 これらのパラメータは、地域内の日本固有の管理ユニットを分類するために使用され、他の国や地域には適用されません。

これらの値を使用して、ブロック番号、郵便番号、サブ地区など、日本のさまざまな種類の管理ユニットを分類します。これらの管理ユニットに関する特定の情報を必要とするアプリケーションを構築する場合に役立ちます。

HERE Vector Tile API で使用できるマップ レイヤーパラメータの詳細について は、「 Layer パラメータ」を参照してください。

日本のcoreレイヤーパラメーター内のkind値の一覧については、次の一覧を参照してください。

• aza - ブロック番号や小さな村など、地域内の管理ユニットを指します。 日本では、「 aza 」という言葉を使用して、小規模な行政区を示します。
• microhood - ブロック番号や郵便番号など、地域内の管理ユニットを指します。
• oaza - より広い地域内のサブ地区を指します。通常は日本で農村地域を記述するために使用されます。

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

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

このkind_detail値は、locality、region、および microhood の、Places の Kindに関する詳細情報を提供します。

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

• city - 人口 10 万人以上の場所の場合。
• town - 人口 10,001 ～ 100,000 人の場所
• village － 201 人から 10,000 人までの人口のある場所。
• hamlet - 人口が 200 以下の場所、または hamlet ソースデータのサブタイプの場合。
• locality - ラベルタイプにデータが含まれておらず、データヒントがない場所の場合。

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

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

• state - 状態レベルのリージョンの場合。
• province - 州レベルの地域の場合。

microhood 日本および core マップ レイヤーパラメーターでのみ使用できる種類のフィーチャーの kind_detail 場合、このプロパティには次のような値を設定できます。

• block - ブロック番号の場合、住所を特定するには地番が必要です。
• parcel - 番地を特定するために地番を必要としない郵便番号の場合。

次のステップ

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