Spring til indhold

Grundfast

Søg i bygninger

Alle stående bygninger i en kommune eller et postnummer, filtreret på anvendelse, opførelsesår, varme, materialer, asbest, areal og olietank.

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.

kommunekode eller postnr skal angives. 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).

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 eller format=geojson kræver Starter eller højere; uden den svarer de med 402.

Et tomt BBR-felt er ukendt, ikke nej: en bygning uden registreret asbest eller varmeinstallation matcher ikke et filter på feltet.

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).

Eksempel

curl "https://api.grundfast.dk/v1/bbr/bygninger/soeg?kommunekode=0740&anvendelse=institution&tag=3&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. Denne eller postnr er påkrævet.Eksempel: 0740
postnrstringqueryvalgfri
Postnummeret, fx 8600. Denne eller kommunekode er påkrævet.
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.
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 eller GeoJSON.Standard:100Eksempel: 1
formatstringqueryvalgfri
json, csv eller geojson (FeatureCollection af punkter).Standard:json

Felter i svaret

antalinteger
Det præcise antal bygninger, der matcher.
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.

Statuskoder

StatusBetydning
200Svaret er leveret.
400Hverken kommunekode eller postnr er angivet, eller et filter er ugyldigt.
401Nøglen mangler eller er ugyldig.
402Side 2 og frem eller CSV/GeoJSON kræver Starter eller højere.
429Burst-grænsen eller månedskvoten er nået. Se Retry-After.
503Bygningsindekset er ikke indlæst i dette miljø.

Fejl har altid formen { "error": "…" }. Se Fejl og statuskoder for, hvad der kan prøves igen.

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.