ガイドAPIリファレンス
ガイド

土地利用レイヤー

土地利用とは、人間が農業、居住、工業、鉱業、レクリエーションなどのさまざまな経済的活動や文化的活動のために土地を利用する方法のことです。

HERE Vector Tile APIでは、landuseレイヤーは特定の地理的地域のさまざまな土地利用タイプに関する情報を提供します。このレイヤーは、さまざまな土地利用タイプを簡単に区別でき、ユーザーが探索対象の地域をより的確に把握できるようになるため、地図の開発者にとって重要です。

次の図は、landuse レイヤーがレンダリングされたときのフィーチャーのサンプルを示しています。

ニューヨークのセントラル パーク

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

  • レイヤー名:landuse
  • ジオメトリータイプ:pointpolygonline

共有プロパティ

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

📘

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

  • name - landuseフィーチャーの名前 (ある場合)。フィーチャーや使用可能なデータによっては、名前が複数の言語で提供される場合もあります。
  • id - landuse フィーチャーの一意の識別子。
  • kind - landuse フィーチャーのタイプ。たとえば、industrialurbanpark など。
  • sort_rank - 地図上のさまざまなタイプの landuse フィーチャーの表示順序を優先させるために使用される値。sort_rank の値が大きい landuse フィーチャーは、sort_rank の値が小さい landuse フィーチャーの上に表示されます。
  • area - landuse フィーチャーの面積 (平方メートル)。面積は球面メルカトル図法で算出されます。このプロパティは、polygon フィーチャーにのみ有効です。
  • min_zoom - landuse フィーチャーを表示するための推奨最小ズーム レベル。

次の図は、landuse フィーチャーの例と、フィーチャーが地図上でどのようにレンダリングされるかを示しています。

土地利用の例

条件プロパティ

一部の landuse フィーチャーには、対応する土地利用の kind にのみ固有のプロパティが含まれています。たとえば、tollプロパティは、道路ポリゴンに対応する種類のlanduseフィーチャーにのみ使用できます。

📘

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

  • toll - 一般的な交通手段を使ってこのフィーチャーを移動する場合、料金を支払う必要があるかどうかを示す任意のブール型プロパティ。このプロパティに指定できる値は true のみです。このプロパティは expresswayurban_expresswayother_road などの道路ポリゴンの種類 でのみ使用できます。
  • kind_detail - 土地利用 kind についての追加情報。詳細については、「kind の追加情報」を参照してください。

Kindの定義と並べ替え順

kind値とsort_rank値は、HERE Vector Tile APIのlanduseフィーチャーの重要なプロパティです。kindプロパティはlanduseフィーチャーのタイプを指定し、sort_rankプロパティはそのフィーチャーが地図上でどの程度目立つかを示します。

  • urban_area (sort_rank:16) - 近隣地域の境界。
  • reservation (sort_rank:17) - 特定の用途向けに確保されている土地。
  • national_park (sort_rank:18) - 州立公園、国立公園、国立森林公園。
  • glacier (sort_rank:29) - 大規模な氷域。
  • desert (sort_rank:30) - 乾燥した居住できない土地。
  • forest (sort_rank:31) - 森林地帯。
  • urban (sort_rank:32) - 建物が密集するエリア。
  • military (sort_rank:33) - 軍事基地や軍事施設。
  • low_emission_zone (sort_rank:40-41) - 環境ゾーンや渋滞エリア。
  • university (sort_rank:42) - キャンパスと大学の敷地。
  • park (sort_rank:43) - 都市公園や公共の庭園。
  • allotments (sort_rank:44) - 野菜の栽培に使用されている土地区画。
  • beach (sort_rank:45) - 砂または小石で覆われた海岸線。
  • aerodrome (sort_rank:46) - 空港、滑走路。
  • railway (sort_rank:47) - 路線、駅。
  • harbour (sort_rank:48) - 港、マリーナ。
  • theme_park (sort_rank:54) - 遊園地、娯楽施設。
  • industrial (sort_rank:55) - 工業地域、製造業地域。
  • commercial (sort_rank:56) - 小売店、商業地。
  • zoo (sort_rank:57) - 動物園、野生動物公園。
  • hospital (sort_rank:60) - 医療施設、病院。
  • golf_course (sort_rank:62) - ゴルフ場、ゴルフ練習場。
  • runway (sort_rank:79) - 滑走路、ヘリポート。
  • sports_centre (sort_rank:81) - スポーツ センター、スタジアム。
  • cemetery (sort_rank:92) - 埋葬地、墓地。
  • pedestrian (sort_rank:112) - 歩行者ゾーン、歩道。
  • parking (sort_rank:123) - 駐車場、ガレージ。
  • water_park (sort_rank:124) - ウォーターパーク、水泳施設。
  • parcel (sort_rank:230) - オーストラリアとニュージーランドでは、土地区画を表すラインの表示のカバレージがズーム 15 以上で制限されます。

コアマップの日本固有の kind の定義と並べ替え順

次のkind値と対応するsort_rank値のリストは、core地図パラメーター内の世界の一部の地域にのみ適用されます。 HERE Vector Tile APIで使用可能な地図パラメーターの詳細については、「地図パラメーター」を参照してください。

  • underground_city (sort_rank:0) - 地下通路。
  • city_mesh - (sort_rank:1) - 都市エリアの都市メッシュ ポリゴン。
  • flood_prone_area (sort_rank:32) - 洪水が発生しやすい地域。
  • low_speed_zone (sort_rank:39) - 低速ゾーン。一般的に、これらのゾーンは安全対策として制限速度の低減を実施し、歩行者がコミュニティ道路に沿って安全に移動できるようにしています。
  • attraction (sort_rank:40) - 一般的な観光スポット。
  • accomodation_facility (sort_rank:41) - 宿泊施設。
  • wetland (sort_rank:42) - 湿地帯。
  • imperial_facility (sort_rank:43) - 緑に囲まれた宮殿などの皇室の施設。
  • outdoor_facility (sort_rank:45) - 屋外施設。
  • institutional_office (sort_rank:45) - 機関の事務所。
  • transportation (sort_rank:46) - 一般的な輸送インフラストラクチャー。
  • place_of_worship (sort_rank:47) - さまざまな宗教地域。
  • railway_station (sort_rank:47) - 駅エリアでの低いズーム レベル (13~15) での簡素化されたポリゴン表示。
  • commuter_station (sort_rank:48) - 通勤列車駅エリアでの低いズーム レベル (13~15) での簡素化されたポリゴン表示。
  • other_facilities (sort_rank:48) - その他の施設。
  • sand (sort_rank:89) - ビーチやゴルフ場のバンカーなどの砂地。
  • school (sort_rank:93) - 学校。
  • grass (sort_rank:125) - 芝生などの緑地。
  • paved_area (sort_rank:189) - 一般的な舗装エリア。
  • dam (sort_rank:223) - ダム ポリゴン。
  • breakwater (sort_rank:224) - 防波堤、ズームレベル 13 と 14 で線形フィーチャーとして、ズームレベル 15 以上で詳細ポリゴンとして表示されます。
  • block (sort_rank:385) - 都市ブロック ポリゴン。
  • city_divider (sort_rank:385) - 料金所の交通分離帯。
  • pedestrian (sort_rank:386) - 大通りの歩道。水上に配置するための一時的な並べ替え順。
  • outdoor_facility (sort_rank:397) - 屋外施設。
  • grassland (sort_rank:401) - 植林地、森林の一部ではない緑地、ゴルフ場のフェアウェイ。他の緑地と区別するために使用します。
  • steps (sort_rank:403) - 階段。
  • divider (sort_rank:405) - 交通分離帯。
  • tunnel_entrance (sort_rank:421) - トンネルの出入口。

次の図は、日本固有の landuse フィーチャーの例を示しています。 日本の landuse フィーチャー

コアマップの日本固有の装飾ライン

以下は、日本のコアマップにおけるズーム レベル 14 以上での装飾ラインの土地利用の kind 値と sort_rank 値の一覧です。

  • decorative_dashed_line (sort_rank:403) - トンネルの境界線などの破線。
  • decorative_solid_line (sort_rank:407) - 実線。
  • toll_gate (sort_rank:408) - 料金所。
  • flood_gate (sort_rank:409) - 水門。
  • erosion_control_dam (sort_rank:410) - 砂防ダム。
  • decorative_ferry_route (sort_rank:411) - フェリーの航路。
  • decorative_passenger_boat_route (sort_rank:412) - 旅客船の航路。
  • decorative_stairs_line (sort_rank:413) - 階段の装飾ライン。
  • decorative_road_surface_or_stairs_line (sort_rank:414) - 路面または階段のライン。
  • decorative_center_divider (sort_rank:415) - 中央分離帯。
  • decorative_road_background (sort_rank:416) - 道路の背景。
  • decorative_expressway (sort_rank:417) - 高速道路の縁線。
  • decorative_road_overpass (sort_rank:418) - 高架道路。
  • decorative_railroad_overpass (sort_rank:419) - 鉄道高架。
  • decorative_buffer_stop (sort_rank:420) - 車止め。

コアマップの日本固有のポリゴン道路

道路ポリゴンは、ポリゴンを使用して道路区間の範囲と形状を定義する道路のタイプです。このような道路は、ロータリー、袋小路、カーブした道路区間など、従来の直線形状から外れる道路を描画するのによく使用されます。

日本固有の道路ポリゴンの core マップには、ズーム 14 以上でカバレージが制限される kind 値が含まれており、道路をポリゴンで詳細に表現できます。これらの値は、roads フィーチャーの is_present_in_landuse プロパティにあります。詳細については、「道路」を参照してください。

次の値が含まれます。

  • other_road (sort_rank:378) - tertiary などの道路。roads レイヤーでは中央線としても表示されます。
  • major_road (sort_rank:380) - secondary などの道路。roads レイヤーでは中央線としても表示されます。
  • national_road (sort_rank:381) - primary などの道路。roads レイヤーでは中央線としても表示されます。
  • urban_expressway (sort_rank:381) - motorway などの都市高速道路。roads レイヤーでは中央線としても表示されます。
  • expressway (sort_rank:384) motorway などの高速道路。roads レイヤーでは中央線としても表示されます。
  • road_in_restricted_area (sort_rank:400) - 公園、歩行者エリア、ゴルフ場など、制限エリア内の道路。roads レイヤーで中央線として表示されません
  • road_under_construction (sort_rank:401) - 建設中の道路。roads レイヤーでは中央線としても表示されます。

次の図は、日本の道路ポリゴンを表す landuse フィーチャーの例を示しています。

日本の道路ポリゴン

kind の追加情報

土地利用の kind_detail 値は、landuse フィーチャーのタイプに関する追加情報を提供します。これらは土地用途エリアの特定の特徴を説明するために使用されます。

たとえば、オブジェクトの種類のプロパティが other_road である場合、kind_detail 値として service が設定されていることがあります。これはその道路が、駐車場やガソリンスタンドなどの道路利用に関連する施設のサービス機能として指定されていることを示しています。

以下は、共通の kind_detail 値の一覧です。

  • environmental - 環境ゾーン用。
  • congestion - 渋滞エリア用。

以下は、core マップの日本固有の kind_detail 値の一覧です。

  • primary - national_road kind 用。
  • secondary_city - major_road kind 用。
  • tertiary - major_road kind 用。
  • tertiary_city - major_road kind 用。
  • service - other_road kind 用。

低ズームでの統合

ズーム レベルが12未満の場合、HERE Vector Tile APIは特定のタイプのlanduseフィーチャーをまとめ、不要な詳細情報を削減し、隣接するlanduseフィーチャーを途切れることなく結合するようにします。

📘

idプロパティは統合されたlanduseフィーチャーには使用できません。

現在、次のマッピングが設定されています。

  • commercialurban_area に統合されます。
  • industrialurban_area に統合されます。
  • parkingurban_area に統合されます。

次のステップ

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