Data & methodology

What rastr returns, where the numbers come from, and how an address becomes a statistic.

Coverage

rastr covers Germany only. Geocoding is restricted to German addresses, and demographic values are attached to the 100 m grid cells published by the Federal Statistical Office. An address resolves to exactly one cell — the cell its coordinates fall inside — so two neighbouring buildings can sit in different cells and return different figures.

Fields

A demographics lookup returns the following. Any field can be null when the underlying cell has no published value.

population: Total residents in the cell.
ageUnder10 … age80AndOver: Residents per age band, in nine bands from under 10 to 80 and over.
single, married, widowed, divorced: Residents per marital status: single, married, widowed, divorced.
averageHouseholdSize: Mean number of people per household in the cell.
datasetYear: The year the underlying dataset describes.
effectiveQuarter: The quarter within that year, where quarterly detail exists.
isEstimated: True when the value was projected forward rather than taken directly from the census.

Freshness

The base layer is Zensus 2022, the most recent full German census. On top of it, official population updates are carried forward quarter by quarter. Every response tells you which vintage you received: datasetYear and effectiveQuarter identify the period, and isEstimated is true whenever the figure was projected rather than measured. Census values and projected values are never silently mixed within a single field.

Methodology

An address is geocoded to coordinates through Mapbox, restricted to Germany. Those coordinates are matched to the 100 m grid cell that contains them, and that cell's published statistics are returned. Where a figure is not published for the exact period requested, it is interpolated between the periods that are. Cells containing fewer than five persons are suppressed at source by the Federal Statistical Office to protect individual privacy; for those cells we return no value rather than a guess.

Limitations

Values are computed by interpolation and may be updated or corrected at any time. We do not guarantee that the data is accurate, complete, or up to date, and it does not constitute legal, tax, or professional advice. Coverage is limited to Germany. Cells with fewer than five persons are suppressed and return no value.

Sources & licences

Demographic data comes from the Federal Statistical Office of Germany. Geocoding and map tiles come from Mapbox and OpenStreetMap.

Demographics: © Statistisches Bundesamt (Destatis), Zensus 2022
Datenlizenz Deutschland – Namensnennung – Version 2.0