---
title: "OSM landuse areas (residential/commercial/retail/industrial/institutional)"
method: POST
path: "/api/osm-geo/landuse-areas"
tags: ["OSM Geo (OpenStreetMap)"]
---

# OSM landuse areas (residential/commercial/retail/industrial/institutional)

`POST /api/osm-geo/landuse-areas`

## Request

- Base URL: `https://api.cernion.de`
- URL: `https://api.cernion.de/api/osm-geo/landuse-areas`
- Auth: none declared

Fetches OSM `landuse=*` way polygons within an area and computes their area (shoelace formula on a local planar projection) and centroid locally — no external MCP dependency, same Overpass data source as osm-geo.gridTopology. Intended as sector-split evidence for municipal load/consumption estimation (area share by landuse type instead of equal distribution across a municipality). **Scope limitation:** only simple closed way polygons are handled — multipolygon relations (areas with excluded inner holes) are not fetched in v1, which understates totals for whichever areas happen to be relation-mapped rather than miscalculating them. **Scope input:** at least one of `location`, `postalCode`, or `boundingBox`.

## Query parameters

- `token` string

## Request body

- object
  - `location` string
  - `postalCode` string
  - `boundingBox` object
    - `north` number
    - `south` number
    - `east` number
    - `west` number
  - `landuseTypes` string[]: Restrict to these landuse types (default: all 5 supported).
  - `token` string: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

## Response `200`

Landuse areas and per-type summary

---

[API](https://skmtc.dev/cernion/apis/cernion-energy-tools-api.md) · [All operations](https://skmtc.dev/cernion/apis/cernion-energy-tools-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cernion/apis/cernion-energy-tools-api/revisions/cdb94473b538?raw)