Demografiedaten
Bevölkerungszahlen, Altersgruppen, Haushaltszahlen und Kaufkraft für einen Radius um eine beliebige deutsche Koordinate abrufen.
Das Tool demographics_fetch gibt Demografiedaten für ein Einzugsgebiet um eine Koordinate zurück. Nur Deutschland.
Verwendung
demographics_fetch(lat, lon, radius_m?)
Wenn Sie nur eine Adresse haben, geocodieren Sie diese zuerst mit dem geocode-Tool von mapular-geo und übergeben dann die Koordinaten.
Radius
radius_m — beliebige ganze Zahl zwischen 150 und 5000 Metern (Standard: 1000). Die vier Voreinstellungen (150, 500, 1000, 1500) verwenden schnelle H3-k-Ring-Abfragen; alle anderen Werte nutzen H3-Polyfill-Geometrie. Die Auflösung wird automatisch gewählt: ≤600 m → Res 9, ≤2000 m → Res 8, ≤5000 m → Res 7.
Häufige Voreinstellungen:
radius_m | H3-Res | Ungefähre Fläche |
|---|---|---|
150 | 9 | ~0,11 km² |
500 | 9 | ~0,74 km² |
1000 | 8 | ~5,16 km² (Standard) |
1500 | 8 | ~14 km² |
Rückgabewerte
| Feld | Beschreibung |
|---|---|
population_total | Gesamtbewohner |
pop_band_0_14 | Bewohner im Alter 0–14 |
pop_band_15_29 | Bewohner im Alter 15–29 |
pop_band_30_44 | Bewohner im Alter 30–44 |
pop_band_45_59 | Bewohner im Alter 45–59 |
pop_band_60_plus | Bewohner im Alter 60+ |
pop_share_30_59 | Anteil der 30–59-Altersgruppe (0–1) |
households_total | Gesamthaushalte |
households_avg_size | Durchschnittliche Haushaltsgröße |
purchasing_power_eur_per_capita | Jährliche Kaufkraft pro Einwohner (EUR) |
purchasing_power_mio_eur | Gesamtkaufkraft im Einzugsgebiet (Mio. EUR) |
purchasing_power_index | Index vs. Bundesdurchschnitt (100 = Bundesdurchschnitt) |
population_density_per_km2 | Einwohner pro km² |
coverage_warning | null = vollständige Abdeckung, "partial" = Rand des Datensatzes, "out_of_coverage" = keine Daten |
output_path | Parquet-Datei mit zellenweisen Rohdaten für Detailanalysen |
Latenz beim ersten Aufruf
Der erste Aufruf lädt den DE-Demografiedatensatz herunter und speichert ihn im Cache (~10–30 Sekunden). Nachfolgende Aufrufe werden aus dem lokalen Cache bedient und dauern unter einer Sekunde.
Beispiel
1. geocode("Hauptbahnhof, München") → lat=48,1402, lon=11,5583
2. demographics_fetch(48.1402, 11.5583, radius_m=1000)
→ population_total: 28400, purchasing_power_index: 112,4, households_total: 14800
# Eigener Radius (Polyfill):
demographics_fetch(52.52, 13.405, radius_m=640)
→ Res-9-Polyfill, Ergebnis enthält radius_m: 640 (keine Rundung)