Søg i bygninger
Alle stående bygninger i hele landet, en kommune, et postnummer eller et kortudsnit — filtreret på BBR-fakta og på grundareal, jordforurening, fredning og energimærke.
https://api.grundfast.dk/v1/bbr/bygninger/soegBygningssøgningen svarer på spørgsmål om bygningsbestanden frem for om én ejendom: hvilke huse fra før 1960 i en kommune opvarmes stadig med olie, hvor står der tage af fibercement, hvilke bygninger har en olietank i brug på grunden. Svaret kommer fra et nationalt bygningsindeks over BBR, med adresse, BFE-nummer og WGS84-punkt på hver bygning, så resultatet kan gå direkte videre til Hent en ejendom.
Området er højst ét af kommunekode, postnr og bbox (et kortudsnit på højst 1° hver vej). Uden område søger du i hele landet. Alle filtre kombineres med OG; et filter med flere koder (fx varme=2,7) matcher enhver af dem. anvendelse tager både BBR-koder og grupper (bolig, enfamiliehus, raekkehus, etagebolig, landbrug, industri, energi, handel_kontor, institution, sommerhus, fritid, udhus_garage).
Ud over BBR’s egne felter (inkl. etager, afløb, spildevandspåbud, solceller og jordvarme) kan du filtrere på fakta fra andre registre, som indekset har koblet på bygningen: ejendommens grundareal fra Matriklen, kortlagt jordforurening (V1/V2) fra Danmarks Miljøportal, fredning og SAVE-værdi fra Slots- og Kulturstyrelsen og energimærkets klasse fra Grundfasts energimærke-korpus.
antal er altid det præcise antal bygninger, der matcher. Alle planer får antallet og første side (op til 100 bygninger som JSON). Flere sider og format=csv, jsonl eller geojson kræver Starter eller højere; uden den svarer de med 402. Søgninger i en kommune eller et postnummer sorteres efter adresse, kortudsnit og hele landet efter bygnings-id.
Med group_by svarer søgningen med en fordeling i stedet for en side bygninger: det præcise antal pr. gruppe for samme filter, i ét kald. aarti grupperer på opførelsesårti (1960 = 1960–1969), tag på tagdækningsmateriale, anvendelse på BBR-anvendelse, kommune på kommunekode, varme på varmeinstallation og energimaerke på energimærkets klasse. Svaret har type: "bygningsgruppering", antal (summen) og grupper med noegle, tekst, antal og andel. Det er åbent for alle planer og kun JSON. Det virker for ethvert område, også hele landet.
Godkendelse · API-nøgle
Send din nøgle som Authorization: Bearer gf_live_… — eller gf_test_… for gratis sandbox-kald. Se Godkendelse og nøgler.
Kræver Starter-planen til side 2 og frem samt CSV/GeoJSON
På en lavere plan svarer resten af endpointet som normalt, og side 2 og frem samt CSV/GeoJSON giver 402. Se planerne.
Afregning
Ét kald pr. påbegyndte 1.000 rækker i per_side (standard 100 = ét kald). Med group_by altid ét kald.
Eksempel
curl -G "https://api.grundfast.dk/v1/bbr/bygninger/soeg" \
--data-urlencode "kommunekode=0740" \
--data-urlencode "anvendelse=institution" \
--data-urlencode "tag=3" \
--data-urlencode "per_side=1" \
-H "Authorization: Bearer $GRUNDFAST_API_KEY"{
"type": "bygningssoegning",
"antal": 180,
"side": 1,
"per_side": 1,
"sider": 180,
"begraenset": false,
"bygninger": [
{
"id": "69eaf49f-6930-47e9-8b65-d1b91ce38d5a",
"bfe_nummer": 4040359,
"adgangsadresse_id": "0a3f5095-4239-32b8-e044-0003ba298018",
"adresse": "A.Andersens Vej 24B, 8600 Silkeborg",
"kommunekode": "0740",
"postnr": "8600",
"koordinat": { "lon": 9.585017, "lat": 56.191006 },
"anvendelse": { "kode": "429", "tekst": "Anden bygning til undervisning og forskning" },
"opfoerelsesaar": 1968,
"om_tilbygningsaar": null,
"samlet_areal": 180,
"boligareal": 179,
"erhvervsareal": 180,
"antal_etager": 1,
"varmeinstallation": { "kode": "1", "tekst": "Fjernvarme/blokvarme" },
"opvarmningsmiddel": null,
"supplerende_varme": { "kode": "1", "tekst": "Varmepumpe" },
"tagdaekning": { "kode": "3", "tekst": "Fibercement herunder asbest" },
"ydervaeg": { "kode": "1", "tekst": "Mursten" },
"asbest": null,
"olietank": false
}
],
"meta": {
"kilde": "BBR + DAR (Datafordeler) via Grundfast — bygningsindeks",
"grundfast_version": "0.1.0"
}
}Parametre
kommunekodestringqueryvalgfri- Kommunekoden, fx
0740. Højst ét afkommunekode,postnrogbbox.Eksempel:0740 postnrstringqueryvalgfri- Postnummeret, fx
8600. bboxstringqueryvalgfri- Kortudsnit
minLon,minLat,maxLon,maxLati WGS84, højst 1° hver vej, fx12.50,55.65,12.62,55.71. anvendelsestringqueryvalgfri- Kommasepareret liste af BBR-anvendelseskoder og/eller grupper.Eksempel:
institution opfoert_fraintegerqueryvalgfri- Opført i dette år eller senere.
opfoert_tilintegerqueryvalgfri- Opført i dette år eller tidligere.
varmestringqueryvalgfri- Koder for varmeinstallation (BBR felt 056), fx
2,7. opvarmningstringqueryvalgfri- Koder for opvarmningsmiddel (felt 057), fx
3for flydende brændsel. tagstringqueryvalgfri- Koder for tagdækning (felt 033), fx
3for fibercement herunder asbest.Eksempel:3 ydervaegstringqueryvalgfri- Koder for ydervæggens materiale (felt 032).
asbeststringqueryvalgfrija: BBR registrerer asbestholdigt materiale (felt 036, kode 1-4).nej: registreret uden asbest (kode 5).areal_minintegerqueryvalgfri- Mindste samlede bygningsareal i m².
areal_maxintegerqueryvalgfri- Største samlede bygningsareal i m².
boligareal_minintegerqueryvalgfri- Mindste boligareal i m².
boligareal_maxintegerqueryvalgfri- Største boligareal i m².
olietankstringqueryvalgfrija: der er registreret en olietank i brug (ikke sløjfet) på grunden.nej: der er ikke.etager_min · etager_maxintegerqueryvalgfri- Antal etager (BBR felt 054).
grundareal_min · grundareal_maxintegerqueryvalgfri- Ejendommens registrerede areal i Matriklen (alle dens jordstykker) i m².
energimaerkestringqueryvalgfri- Energimærkets klasse, kommasepareret, fx
F,G. Finder kun mærker, der er i Grundfasts korpus — dækningen er delvis. afloebstringqueryvalgfri- Koder for afløbsforhold (felt 031, ellers grundens felt 010).
spildevandspaabudstringqueryvalgfrija: BBR registrerer et påbud om forbedret rensning eller tilslutning (rensningspåbud 2-7).nej: “Rensning ok. Intet påbud”.solceller · jordvarmestringqueryvalgfrija/nej: et solcelleanlæg (teknisk anlæg 1230) eller jordvarmeslanger (1220) i brug på grunden eller bygningen.jordforureningstringqueryvalgfriv1,v2,kortlagt(enten) ellernej: kortlægning på en af ejendommens matrikler.fredetstringqueryvalgfrija/nej: bygningen er fredet.bevaringsvaerdi_maxintegerqueryvalgfri- SAVE-værdi højst dette tal (1 er højest), fx
4. sideintegerqueryvalgfri- Sidenummer. Side 2 og frem kræver Starter eller højere.Standard:1
per_sideintegerqueryvalgfri- Bygninger pr. side: højst 1.000 som JSON og 10.000 som CSV, JSON Lines eller GeoJSON.Standard:100Eksempel:
1 formatstringqueryvalgfrijson,jsonl(én bygning pr. linje),csvellergeojson(FeatureCollection af punkter).Standard:jsongroup_bystringqueryvalgfri- Svar med antal pr. gruppe i stedet for bygninger:
aarti(opførelsesårti),tag(tagdækning),anvendelse,kommune,varme(varmeinstallation) ellerenergimaerke(energimærkets klasse). Kun JSON;sideogper_sideignoreres. Svaret er da{ type: "bygningsgruppering", group_by, antal, grupper: [{ noegle, tekst, antal, andel }] }.
Felter i svaret
antalinteger- Det præcise antal bygninger, der matcher.
grupper[]{ noegle, tekst, antal, andel }[]- Kun med
group_by.noegleer årtiets første år ("1960"), BBR-koden ("3"), kommunekoden ("0751") eller energimærkets klasse ("C");nuller bygninger uden registreret værdi — forenergimaerkebygninger uden et mærke i vores data. Foraartitæller BBR’s pladsholderår 1000 også som ukendt.andeler gruppens andel afantal(0–1).aartistår i årti-rækkefølge med ukendt sidst, de øvrige efter antal. begraensetbooleantrue, når planen begrænsede svaret til første side.antaler stadig præcist.bygninger[].olietankboolean- Der er registreret en olietank i brug på bygningens grund eller på bygningen selv. Siger intet om, hvad bygningen opvarmes med.
bygninger[].asbest{ kode, tekst } | null- BBR-feltet om asbestholdigt materiale.
nullbetyder, at feltet ikke er udfyldt, ikke at bygningen er fri for asbest. bygninger[].jordforurening'V1' | 'V2' | 'V1 og V2' | null- Kortlægning på en af ejendommens matrikler.
null: ikke kortlagt. bygninger[].energimaerke'A' … 'G' | null- Klassen, når ejendommens mærke er i Grundfasts korpus.
nullbetyder ikke, at ejendommen er uden mærke. omfang'kommune' | 'postnummer' | 'kortudsnit' | 'hele_landet'- Det område, søgningen dækkede.
Statuskoder
| Status | Betydning |
|---|---|
| 200 | Svaret er leveret. |
| 400 | Mere end ét område, et kortudsnit over 1° eller uden for Danmark, group_by kombineret med format=csv/jsonl/geojson, eller et ugyldigt filter. |
| 401 | Nøglen mangler eller er ugyldig. |
| 402 | Side 2 og frem eller CSV/JSON Lines/GeoJSON kræver Starter eller højere. |
| 429 | Burst-grænsen eller månedskvoten er nået. Se Retry-After. |
| 503 | Bygningsindekset (eller den udvidede version, et filter kræver) er ikke indlæst, eller landsdækkende søgning har travlt. Se Retry-After. |
Alle fejl har samme form. Byg logikken på type (fejlklassen) og vis message (dansk tekst med årsagen) til brugeren; hint kommer med, når vi kan se, hvad der skal rettes, og request_id er det, support skal bruge. Se Fejl og statuskoder for hver type, og hvad der kan prøves igen.
{
"error": "property not found",
"type": "not_found",
"code": "not_found",
"message": "Ressourcen findes ikke.",
"request_id": "6cbfa45a-a9ea-4140-9d42-ea752a70ff1f",
"doc_url": "https://grundfast.dk/docs/fejl#not_found"
}Prøv det
Live-kald fra siden
Bruges ofte sammen med
Læs mere om BBR, og hvad data kan bruges til, på produktsiden.