---
id: "land_cover_class"
kind: "datatype"
status: "draft"
is_pii: false
name: "Land cover class"
regexp: "^(?i:forests?(?: land)?|woodland|tree cover|trees|shrubland|shrubs?|scrub(?:land)?|grassland|grass|herbaceous(?: vegetation)?|pastures?|pastureland|meadows?|cropland|crops?|cultivated(?: land)?|arable(?: land)?|agricultural land|orchards?|vineyards?|wetlands?|herbaceous wetland|mangroves?|settlements?|built[- ]?up(?: area)?|urban(?: area)?|artificial surfaces?|bare(?: land| soil| ground| areas?)?|bare ?/ ?sparse vegetation|sparse vegetation|barren(?: land)?|water|water bodies|permanent water bodies|open water|snow and ice|snow ?/ ?ice|permanent snow and ice|moss and lichen|lichens and mosses|other land)$"
categories: ["environment", "geo"]
langs: ["en"]
quality: 90
url: "https://registry.apicrafter.io/datatype/land_cover_class"
---

# Land cover class (`land_cover_class`)

> **Draft.** Draft records have not been reviewed yet and may be incomplete or wrong; do not treat them as authoritative for legal or compliance decisions.

Name of a land cover or land use class of a site or an area: the six land-use categories of the IPCC guidelines for greenhouse gas inventories (forest land, cropland, grassland, wetlands, settlements, other land), the eleven classes of the ESA WorldCover map (tree cover, shrubland, grassland, cropland, built-up, bare / sparse vegetation, snow and ice, permanent water bodies, herbaceous wetland, mangroves, moss and lichen) and the plain words of soil and vegetation surveys (forest, shrubland, pasture, orchard, urban, barren; Land_cover of the soil profile database of the Armenian Soil Information System: cropland, grassland, shrubland, forest). Codes of CORINE Land Cover are corine_land_cover_code. The words are common nouns, so only a land cover field tells them apart.

- Parent datatype: [`category`](https://registry.apicrafter.io/datatype/category.md)
- Personal data (PII): no
- Categories: Environment (protected areas, biodiversity, water, weather, emissions, waste) (environment), Geographic identifiers (geo)
- Countries: global
- Languages: English (en)
- Classification: categorical

## Detection

Regular expression (Python `re`):

```
^(?i:forests?(?: land)?|woodland|tree cover|trees|shrubland|shrubs?|scrub(?:land)?|grassland|grass|herbaceous(?: vegetation)?|pastures?|pastureland|meadows?|cropland|crops?|cultivated(?: land)?|arable(?: land)?|agricultural land|orchards?|vineyards?|wetlands?|herbaceous wetland|mangroves?|settlements?|built[- ]?up(?: area)?|urban(?: area)?|artificial surfaces?|bare(?: land| soil| ground| areas?)?|bare ?/ ?sparse vegetation|sparse vegetation|barren(?: land)?|water|water bodies|permanent water bodies|open water|snow and ice|snow ?/ ?ice|permanent snow and ice|moss and lichen|lichens and mosses|other land)$
```

## Examples

- `cropland` — Soil profile database of ArmSIS (Land_cover)
- `shrubland` — Soil profile database of ArmSIS
- `Forest land` — IPCC land-use category
- `Tree cover` — ESA WorldCover class
- `Bare / sparse vegetation` — ESA WorldCover class
- `Permanent water bodies` — ESA WorldCover class
- `311` (invalid example) — CORINE Land Cover code (corine_land_cover_code)
- `hill_top` (invalid example) — Landscape position of the same database

## Metacrafter rules

1 rules: 1 match the field name, 0 match values.

- `landcoverbyname` (field, `common/soils.yaml`)

## Supported by tools

- [`metacrafter`](https://registry.apicrafter.io/tool/metacrafter.md)

## Translations

- ru: Класс растительного покрова

## Sources

- wikipedia: <https://en.wikipedia.org/wiki/Land_cover>
- doc: <https://esa-worldcover.org/en>
- doc: <https://www.ipcc-nggip.iges.or.jp/public/2006gl/pdf/4_Volume4/V4_03_Ch3_Representation.pdf>

## Quality

Score 90/100. Missing: mapping (Wikidata, Schema.org, ...).

JSON: <https://registry.apicrafter.io/api/v1/datatypes/land_cover_class.json> · Edit: <https://github.com/apicrafter/metacrafter-registry/edit/main/data/datatypes/any/environment/land_cover_class.yaml>
