Spring til indhold

Grundfast

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.

GET/v1/bbr/bygninger/soeg

Bygningssø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.

Et tomt BBR-felt er ukendt, ikke nej: en bygning uden registreret asbest eller varmeinstallation matcher ikke et filter på feltet.
Energimærker kommer fra Grundfasts korpus, som vokser ejendom for ejendom. Et filter på klassen finder kun de mærker, korpusset har — ikke alle mærker i Danmark.

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"
Svar · eksempel200
{
  "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 af kommunekode, postnr og bbox.Eksempel: 0740
postnrstringqueryvalgfri
Postnummeret, fx 8600.
bboxstringqueryvalgfri
Kortudsnit minLon,minLat,maxLon,maxLat i WGS84, højst 1° hver vej, fx 12.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 3 for flydende brændsel.
tagstringqueryvalgfri
Koder for tagdækning (felt 033), fx 3 for fibercement herunder asbest.Eksempel: 3
ydervaegstringqueryvalgfri
Koder for ydervæggens materiale (felt 032).
asbeststringqueryvalgfri
ja: 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².
olietankstringqueryvalgfri
ja: 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).
spildevandspaabudstringqueryvalgfri
ja: BBR registrerer et påbud om forbedret rensning eller tilslutning (rensningspåbud 2-7). nej: “Rensning ok. Intet påbud”.
solceller · jordvarmestringqueryvalgfri
ja/nej: et solcelleanlæg (teknisk anlæg 1230) eller jordvarmeslanger (1220) i brug på grunden eller bygningen.
jordforureningstringqueryvalgfri
v1, v2, kortlagt (enten) eller nej: kortlægning på en af ejendommens matrikler.
fredetstringqueryvalgfri
ja/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
formatstringqueryvalgfri
json, jsonl (én bygning pr. linje), csv eller geojson (FeatureCollection af punkter).Standard:json
group_bystringqueryvalgfri
Svar med antal pr. gruppe i stedet for bygninger: aarti (opførelsesårti), tag (tagdækning), anvendelse, kommune, varme (varmeinstallation) eller energimaerke (energimærkets klasse). Kun JSON; side og per_side ignoreres. 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. noegle er årtiets første år ("1960"), BBR-koden ("3"), kommunekoden ("0751") eller energimærkets klasse ("C"); null er bygninger uden registreret værdi — for energimaerke bygninger uden et mærke i vores data. For aarti tæller BBR’s pladsholderår 1000 også som ukendt. andel er gruppens andel af antal (0–1). aarti står i årti-rækkefølge med ukendt sidst, de øvrige efter antal.
begraensetboolean
true, når planen begrænsede svaret til første side. antal er 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. null betyder, 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. null betyder ikke, at ejendommen er uden mærke.
omfang'kommune' | 'postnummer' | 'kortudsnit' | 'hele_landet'
Det område, søgningen dækkede.

Statuskoder

StatusBetydning
200Svaret er leveret.
400Mere end ét område, et kortudsnit over 1° eller uden for Danmark, group_by kombineret med format=csv/jsonl/geojson, eller et ugyldigt filter.
401Nøglen mangler eller er ugyldig.
402Side 2 og frem eller CSV/JSON Lines/GeoJSON kræver Starter eller højere.
429Burst-grænsen eller månedskvoten er nået. Se Retry-After.
503Bygningsindekset (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.

Fejlsvar · 404
{
  "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

Demoen svarer med antal og første side som JSON, ligesom en gratis nøgle.

GET /v1/demo/bygninger/soeg?kommunekode=0740&anvendelse=institution&tag=3&per_side=1

Bruges ofte sammen med

Læs mere om BBR, og hvad data kan bruges til, på produktsiden.