Bygningspolygoner-API — GeoDanmark footprints som GeoJSON
Grundfast udstiller GeoDanmarks bygningsfootprints pr. ejendom: alle bygningspolygoner på et BFE-nummer i ét buildings-array med WGS84-ringe, hver bygning koblet til BBR via sin bbr_uuid og klar til Leaflet, Mapbox eller GIS. Ét opslag på /v1/geodanmark/bygninger/:bfe — ingen GML3-parsing, ingen reprojektion.
GET /v1/geodanmark/bygninger/:bfeHvad bygningspolygon-API’et giver dig
Bygningsfootprints pr. ejendom
Ét opslag på BFE-nummeret giver alle bygningspolygoner på ejendommen — footprints fra GeoDanmark samlet i ét buildings-array, i stedet for at du selv skal spørge WFS pr. bygning og pusle geometrien sammen.
WGS84-koordinater, kort-klar
Ringene reprojiceres fra EPSG:25832 til WGS84 (lon, lat) — pak dem i et GeoJSON Polygon og tegn direkte i Leaflet, Mapbox, MapLibre eller et hvilket som helst GIS uden efterbehandling.
Auto-joinet BFE → bygninger
Hver bygning bærer sin bbr_uuid — en reference tilbage til bygningen i BBR. Slå ejendommen op i BBR-API’et og tegn dens fysiske aftryk på kortet — samme BFE, samme datamodel.
Stabil oven på GeoDanmark
Vi henter og cacher GeoDanmarks bygningsdata og retry’er mod upstream, så footprint-opslag står op selv når kilde-WFS’en flapper. Den gamle GML3-WFS udfases ultimo 2026 — Grundfast holder formen kørende.
Footprint + antal_etager
Hvert GeoDanmark-footprint er koblet til BBR-bygningen, så du kan rejse grundfladen efter bygningens etageantal og få en simpel 3D-masse. Figuren her er ægte polygoner ekstruderet efter BBR-etager — ren SVG, intet kort-SDK.
Kald bygningspolygoner i din stack
Samme kald i cURL, den typede TS-SDK og Python — slå ejendommen op på BFE-nummeret og få bygningernes ringe tilbage — pak dem i et GeoJSON Polygon:
curl -H "Authorization: Bearer gf_live_…" \ https://api.grundfast.dk/v1/geodanmark/bygninger/5651067
Status & datakontrakt
Endpointet er GET /v1/geodanmark/bygninger/:bfe med en gf_live_-nøgle — samme auth og metering som de øvrige registre. Svaret er et JSON-objekt med et buildings-array:
# GeoDanmark-footprints for en ejendom, Bearer gf_live_…: GET /v1/geodanmark/bygninger/5651067 → 200 { bfe_nummer: 5651067, buildings: [ { bbr_uuid: "0a3f50a4-1013-…", rings: [ [ [12.5683, 55.6759], # WGS84 (lon, lat), [12.5686, 55.6759], # én ring pr. flade; [12.5686, 55.6761], # ekstra ringe = huller [12.5683, 55.6761], [12.5683, 55.6759] ] ] } ], attribution: "@geodanmark", meta: { kilde: "GeoDanmark via Grundfast", grundfast_version: "0.1.0" } }
Felter i svaret
| Felt | Type | Beskrivelse |
|---|---|---|
| bfe_nummer | number | Ejendommens BFE — samme indgang som BBR og Matriklen. |
| buildings[] | object[] | Én post pr. bygning på ejendommen. |
| buildings[].bbr_uuid | string | BBR-bygningens UUID (GeoDanmark BBRUUID) — koblingen tilbage til BBR. |
| buildings[].rings | number[][][] | Bygningens footprint i WGS84 (lon, lat): en liste af ringe (første er ydersiden, evt. flere er huller). Pak i et GeoJSON Polygon. |
| attribution | string | CC BY 4.0-kredit "@geodanmark" — skal vises hvor footprints tegnes. |
| meta.kilde | string | Kildekredit — "GeoDanmark via Grundfast". |
| meta.grundfast_version | string | Grundfast API-version, f.eks. "0.1.0". |
/v1/geodanmark/bygninger/:bfeBFE-nummer → alle bygningspolygoner i et buildings-array med WGS84-ringe, koblet til BBR via bbr_uuid. Klar at kalde nu.
/v1/bbr/ejendom/:bfeSamme BFE → bygninger og enheder i BBR — kombinér med footprintet for aftryk og attributter på kortet.
Kom i gang med bygningspolygoner
Opret en gratis nøgle og kald /v1/geodanmark/bygninger/:bfe — så har du bygningernes ringe klar til et GeoJSON Polygon på et kort med det samme. Skal du tegne bygninger for en hel portefølje? Skriv til os.
Se også BBR-API’et og Matrikel-API’et.
Ofte stillede spørgsmål
Hvad er et bygningspolygon-API?
Et API der giver dig bygningernes fysiske aftryk (footprints) som geometri. Grundfast udstiller GeoDanmarks bygningspolygoner pr. ejendom: GET /v1/geodanmark/bygninger/:bfe returnerer et buildings-array for et BFE-nummer, hvor hver bygning har sine WGS84-ringe (rings) og sin bbr_uuid, der kobler tilbage til BBR-bygningen. Pak ringene i et GeoJSON Polygon og tegn direkte på et kort.
Hvor kommer bygningspolygonerne fra?
Footprintsene stammer fra GeoDanmark (grunddata-samarbejdet under SDFI), der leverer de landsdækkende bygningsgeometrier. Grundfast henter, cacher og reprojicerer dem til WGS84 og kobler dem til ejendommen via BFE — men sælger transformen og stabiliteten, ikke selve data. Kilden fremgår af meta.kilde i hvert svar, og felt-attribution bærer den CC BY 4.0-kredit (@geodanmark) du skal vise, hvor footprints tegnes.
Hvilket format får jeg polygonerne i?
Et JSON-svar med bfe_nummer og et buildings-array; hver bygning har rings (en liste af ringe i WGS84 lon/lat, hvor første ring er ydersiden og evt. flere er huller) og en bbr_uuid. Pak ringene i et GeoJSON Polygon ({ type: "Polygon", coordinates: rings }) og læg det direkte i Leaflet (L.geoJSON), Mapbox/MapLibre eller et GIS. Den rå GeoDanmark-WFS leverer GML3 i EPSG:25832 — den reprojektion slipper du for.
Er footprintsene koblet til BBR?
Ja. Opslaget sker på BFE-nummeret, samme indgang som BBR-API’et, og hver bygning bærer sin bbr_uuid. Du kan derfor hente ejendommens bygninger og enheder i BBR (GET /v1/bbr/ejendom/:bfe) og tegne det fysiske aftryk fra dette endpoint på samme kort — én ejendom, én datamodel.
Kan jeg rejse bygningerne i 3D efter etageantal?
Ja — kombinér footprintet herfra med BBR-feltet antal_etager på bygningen. Footprintet giver grundfladen, og etageantallet giver højden, så du kan ekstrudere hver bygning til en simpel 3D-masse. Figuren på denne side gør præcis det: GeoDanmark-polygoner rejst efter BBR-etager, i ren SVG.
Er Grundfast officielt / tilknyttet SDFI?
Nej. Grundfast er et uafhængigt compatibility-lag — uofficielt, men det virker. Bygningsdata kommer fra GeoDanmark via SDFI/Datafordeler under CC BY 4.0; vi krediterer kilden.
GeoDanmark — footprints landsdækkende
Bygningspolygoner for hver ejendom i landet, reprojiceret til WGS84 og koblet til BBR — serveret fra den cachede mirror. Kortet er farvet efter hvor mange adresser vi holder i hver kommune.
- Adresser
- 2.700.904
- Jordstykker
- 2.565.631
- Kommuner
- 98