openmaptiles/layers/landcover/landcover.yaml

layer:
  id: "landcover"
  requires:
    tables:
      - ne_10m_antarctic_ice_shelves_polys
      - ne_10m_glaciated_areas
      - ne_50m_antarctic_ice_shelves_polys
      - ne_50m_glaciated_areas
      - ne_110m_glaciated_areas
  description: |
      Landcover is used to describe the physical material at the surface of the earth. At lower zoom levels this is
      from Natural Earth data for glaciers and ice shelves and at higher zoom levels the landcover is [implied by OSM tags](http://wiki.openstreetmap.org/wiki/Landcover). The most common use case for this layer
        is to style wood (`class=wood`) and grass (`class=grass`) areas.
  buffer_size: 4
  fields:
    class:
      description: |
          Use the **class** to assign natural colors for **landcover**.
      values:
        farmland:
          subclass: ['farmland', 'farm', 'orchard', 'vineyard', 'plant_nursery']
        ice:
          subclass: ['glacier', 'ice_shelf']
        wood:
          subclass: ['wood', 'forest']
        rock:
          subclass: ['bare_rock', 'scree']
        grass:
          subclass: ['fell', 'grassland', 'heath', 'scrub', 'shrubbery', 'tundra', 'grass', 'meadow', 'allotments', 'park', 'village_green', 'recreation_ground', 'garden', 'golf_course']
        wetland:
          subclass: ['wetland', 'bog', 'swamp', 'wet_meadow', 'marsh', 'reedbed', 'saltern', 'tidalflat', 'saltmarsh', 'mangrove']
        sand:
          subclass: ['beach', 'sand', 'dune']
    subclass:
      description: |
          Use **subclass** to do more precise styling.
          Original value of either the
          [`natural`](http://wiki.openstreetmap.org/wiki/Key:natural),
          [`landuse`](http://wiki.openstreetmap.org/wiki/Key:landuse),
          [`leisure`](http://wiki.openstreetmap.org/wiki/Key:leisure),
          or [`wetland`](http://wiki.openstreetmap.org/wiki/Key:wetland) tag.
      values:
      - allotments
      - bare_rock
      - beach
      - bog
      - dune
      - scrub
      - shrubbery
      - farm
      - farmland
      - fell
      - forest
      - garden
      - glacier
      - grass
      - grassland
      - golf_course
      - heath
      - mangrove
      - marsh
      - meadow
      - orchard
      - park
      - plant_nursery
      - recreation_ground
      - reedbed
      - saltern
      - saltmarsh
      - sand
      - scree
      - swamp
      - tidalflat
      - tundra
      - village_green
      - vineyard
      - wet_meadow
      - wetland
      - wood
  datasource:
    geometry_field: geometry
    query: (SELECT geometry, class, subclass FROM layer_landcover(!bbox!, z(!scale_denominator!))) AS t
schema:
  - ./generalized.sql
  - ./landcover.sql
datasources:
  - type: imposm3
    mapping_file: ./mapping.yaml
Add landcover layer 2016-10-10 18:37:23 +00:00			`layer:`
			`id: "landcover"`
Add requires.tables to <layer>.yaml (#1236) NOTE this can only be merged after the next tools version is released. Added required Postgres tables to the `<layer>.yaml` definition. Close: #1220 PR of tools: https://github.com/openmaptiles/openmaptiles-tools/pull/370 2021-11-05 09:04:54 +00:00			`requires:`
			`tables:`
Add missing requires NE tables to layers. (#1410) Adding missing requires Natural Earth tables for layers. 2022-08-02 12:22:58 +00:00			`- ne_10m_antarctic_ice_shelves_polys`
			`- ne_10m_glaciated_areas`
Add requires.tables to <layer>.yaml (#1236) NOTE this can only be merged after the next tools version is released. Added required Postgres tables to the `<layer>.yaml` definition. Close: #1220 PR of tools: https://github.com/openmaptiles/openmaptiles-tools/pull/370 2021-11-05 09:04:54 +00:00			`- ne_50m_antarctic_ice_shelves_polys`
Add missing requires NE tables to layers. (#1410) Adding missing requires Natural Earth tables for layers. 2022-08-02 12:22:58 +00:00			`- ne_50m_glaciated_areas`
			`- ne_110m_glaciated_areas`
Add docs for landcover, landuse and housenumber 2016-10-30 15:07:47 +00:00			`description: \|`
			`Landcover is used to describe the physical material at the surface of the earth. At lower zoom levels this is`
Fix stray landcover punctuation 2016-12-08 20:47:58 +00:00			`from Natural Earth data for glaciers and ice shelves and at higher zoom levels the landcover is [implied by OSM tags](http://wiki.openstreetmap.org/wiki/Landcover). The most common use case for this layer`
			is to style wood (`class=wood`) and grass (`class=grass`) areas.
Add landcover layer 2016-10-10 18:37:23 +00:00			`buffer_size: 4`
Add docs for landcover, landuse and housenumber 2016-10-30 15:07:47 +00:00			`fields:`
Add possible values for landcover, landuse, park doc 2016-11-30 11:20:59 +00:00			`class:`
			`description: \|`
			`Use the class to assign natural colors for landcover.`
			`values:`
Manage field mapping in SQL declaratively Simplify some of the OSM->OMT field value mappings using declarative syntax. This approach is not for all cases, but in many it removes the need of storing the same field in both the .yaml and .sql files. TODO: support more complex AND/OR cases 2019-10-26 08:28:51 +00:00			`farmland:`
			`subclass: ['farmland', 'farm', 'orchard', 'vineyard', 'plant_nursery']`
			`ice:`
			`subclass: ['glacier', 'ice_shelf']`
			`wood:`
			`subclass: ['wood', 'forest']`
			`rock:`
			`subclass: ['bare_rock', 'scree']`
			`grass:`
Add natural=shrubbery to landcover (#1397) This adds `natural=shrubbery` to landcover (next to the similar `natural=scrub`). Fixes #1396 2022-06-01 16:20:35 +00:00			`subclass: ['fell', 'grassland', 'heath', 'scrub', 'shrubbery', 'tundra', 'grass', 'meadow', 'allotments', 'park', 'village_green', 'recreation_ground', 'garden', 'golf_course']`
Manage field mapping in SQL declaratively Simplify some of the OSM->OMT field value mappings using declarative syntax. This approach is not for all cases, but in many it removes the need of storing the same field in both the .yaml and .sql files. TODO: support more complex AND/OR cases 2019-10-26 08:28:51 +00:00			`wetland:`
			`subclass: ['wetland', 'bog', 'swamp', 'wet_meadow', 'marsh', 'reedbed', 'saltern', 'tidalflat', 'saltmarsh', 'mangrove']`
			`sand:`
			`subclass: ['beach', 'sand', 'dune']`
Add possible values for landcover, landuse, park doc 2016-11-30 11:20:59 +00:00			`subclass:`
			`description: \|`
			`Use subclass to do more precise styling.`
			`Original value of either the`
			[`natural`](http://wiki.openstreetmap.org/wiki/Key:natural),
			[`landuse`](http://wiki.openstreetmap.org/wiki/Key:landuse),
Fix stray landcover punctuation 2016-12-08 20:47:58 +00:00			[`leisure`](http://wiki.openstreetmap.org/wiki/Key:leisure),
Add possible values for landcover, landuse, park doc 2016-11-30 11:20:59 +00:00			or [`wetland`](http://wiki.openstreetmap.org/wiki/Key:wetland) tag.
			`values:`
			`- allotments`
Add missing `landcover` subclass values Subclass values were extracted from `mapping.yaml` 2019-05-01 05:45:57 +00:00			`- bare_rock`
			`- beach`
			`- bog`
Support natural=dune aside of beach and sand 2019-08-30 20:49:47 +00:00			`- dune`
Map fell, heath, scrub and tundra like grassland, as 'grass' 2019-08-30 20:59:23 +00:00			`- scrub`
Add natural=shrubbery to landcover (#1397) This adds `natural=shrubbery` to landcover (next to the similar `natural=scrub`). Fixes #1396 2022-06-01 16:20:35 +00:00			`- shrubbery`
Add possible values for landcover, landuse, park doc 2016-11-30 11:20:59 +00:00			`- farm`
			`- farmland`
Map fell, heath, scrub and tundra like grassland, as 'grass' 2019-08-30 20:59:23 +00:00			`- fell`
Add possible values for landcover, landuse, park doc 2016-11-30 11:20:59 +00:00			`- forest`
Add gardens to landcover 2017-11-08 12:45:27 +00:00			`- garden`
Add missing `landcover` subclass values Subclass values were extracted from `mapping.yaml` 2019-05-01 05:45:57 +00:00			`- glacier`
			`- grass`
Add possible values for landcover, landuse, park doc 2016-11-30 11:20:59 +00:00			`- grassland`
Add leisure=golf_course, map it to grass 2019-11-14 20:36:17 +00:00			`- golf_course`
Map fell, heath, scrub and tundra like grassland, as 'grass' 2019-08-30 20:59:23 +00:00			`- heath`
Add missing `landcover` subclass values Subclass values were extracted from `mapping.yaml` 2019-05-01 05:45:57 +00:00			`- mangrove`
Add possible values for landcover, landuse, park doc 2016-11-30 11:20:59 +00:00			`- marsh`
Add missing `landcover` subclass values Subclass values were extracted from `mapping.yaml` 2019-05-01 05:45:57 +00:00			`- meadow`
			`- orchard`
			`- park`
			`- plant_nursery`
			`- recreation_ground`
Add possible values for landcover, landuse, park doc 2016-11-30 11:20:59 +00:00			`- reedbed`
			`- saltern`
			`- saltmarsh`
add class and subclass values to documentation 2018-02-01 03:51:51 +00:00			`- sand`
Add missing `landcover` subclass values Subclass values were extracted from `mapping.yaml` 2019-05-01 05:45:57 +00:00			`- scree`
			`- swamp`
			`- tidalflat`
Map fell, heath, scrub and tundra like grassland, as 'grass' 2019-08-30 20:59:23 +00:00			`- tundra`
Add missing `landcover` subclass values Subclass values were extracted from `mapping.yaml` 2019-05-01 05:45:57 +00:00			`- village_green`
			`- vineyard`
			`- wet_meadow`
			`- wetland`
			`- wood`
Add landcover layer 2016-10-10 18:37:23 +00:00			`datasource:`
Introduce landcover classes 2016-10-24 12:27:51 +00:00			`geometry_field: geometry`
Remove osm_id in vector tiles coz of huge size savings 2016-10-25 17:15:51 +00:00			`query: (SELECT geometry, class, subclass FROM layer_landcover(!bbox!, z(!scale_denominator!))) AS t`
Add landcover layer 2016-10-10 18:37:23 +00:00			`schema:`
reworked landcover layer (#1035) Instead of using [Douglas-Peucker algorithm](https://postgis.net/docs/ST_SimplifyPreserveTopology.html) which is using for generalized tables [imposm](https://imposm.org/docs/imposm3/latest/mapping.html#generalized-tables) it is used [Visvalingam-Whyatt algorithm](https://postgis.net/docs/ST_SimplifyVW.html). Solution: remove imposm generalized tables (during `import-osm`) and create generalization in `import-sql` step for zooms 7-14. Zooms 0-6 are from Natural Earth data. Upper zoom levels (7 and 8) are ok to merge with no big impact on creation speed. In Canada from z9 it took too long. Between zoom levels 10 - 13 there can be union polygons with less than 300 edge points (empirical number based on a test on Canada forest, can be discussed). Polygons with more than 300 edge points are just simplified. Zoom 14 is from the original dataset `osm_landcover_polygon`. There is also removed `osm_id` which is never used and not passed into vector tiles. 2020-11-11 13:11:48 +00:00			`- ./generalized.sql`
Add landcover layer 2016-10-10 18:37:23 +00:00			`- ./landcover.sql`
			`datasources:`
			`- type: imposm3`
			`mapping_file: ./mapping.yaml`