---
id: "area"
kind: "datatype"
status: "draft"
is_pii: false
categories: ["values", "common"]
langs: ["common"]
quality: 90
url: "https://registry.apicrafter.io/datatype/area"
---

# Area (surface measure) (`area`)

> **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.

Size of a surface, such as the area of a parcel, a building, a district or a lake, stored as a number in square metres, hectares or square kilometres, with the unit in the value, the column name (Fläche km², ALAND, oppervlakte_ha) or the metadata. The regular expression recognizes only values that carry one of these unit symbols.

- Parent datatype: `numeric`
- Personal data (PII): no
- Categories: All measurable values (percentage, amount and e.t.c) (values), Common (common)
- Countries: global
- Languages: Common to most languages (common)

## Detection

Regular expression (Python `re`):

```
^\d+(?:[.,]\d+)?\s?(?:mm²|cm²|m²|km²|mm2|cm2|m2|km2|ha|sq\.? ?(?:m|ft|mi|km))$
```

## Examples

- `120 m²` — Square metres
- `2,5 ha` — Hectares with a decimal comma
- `35 km2` — Square kilometres written with a 2
- `120 m` (invalid example) — Unit of length
- `m²` (invalid example) — Unit without a number

## Mappings

- wikidata: `P2046`

## Translations

- de: Fläche
- fr: Superficie
- ru: Площадь

## Sources

- wikipedia: <https://en.wikipedia.org/wiki/Area>
- wikidata: <https://www.wikidata.org/wiki/Property:P2046>

## Quality

Score 90/100. Missing: detector coverage.

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