Spring til indhold

Grundfast

Bygningerne som GeoJSON

Ejendommens bygninger som en GeoJSON FeatureCollection med én flad, oversat Feature pr. bygning og et WGS84-punkt som geometri.

GET/v1/bbr/ejendom/{bfe}/geojson

Samme data som Hent en ejendom, men i den flade WFS-form: hver bygning er én Feature, og egenskaberne er skalarer (anvendelse er teksten, anvendelse_kode koden), så svaret kan lægges direkte ind i et kortbibliotek eller et GIS. Grund- og matrikeloplysninger gentages på hver Feature.

Geometrien er bygningens BBR-punkt i WGS84 [lon, lat] og er null for en bygning uden punkt. crs angiver CRS84, og bbox udelades, når ingen bygning har et punkt. Der er ingen paginering: numberMatched er altid lig med numberReturned.

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.

Afregning

Ét kald.

Eksempel

curl "https://api.grundfast.dk/v1/bbr/ejendom/5651067/geojson" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
Svar · eksempel200
{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": null,
      "properties": {
        "bfe_nummer": 5651067,
        "bygning_id": "738cd665-f22f-4fe6-b446-e7a04386c000",
        "bygningsnummer": 1,
        "anvendelse_kode": "120",
        "anvendelse": "Fritliggende enfamiliehus",
        "opfoerelsesaar": null,
        "om_tilbygningsaar": null,
        "antal_etager": null,
        "bebygget_areal_m2": null,
        "samlet_bygningsareal_m2": null,
        "samlet_boligareal_m2": null,
        "ydervaeg": null,
        "tag": null,
        "varme": null,
        "opvarmningsmiddel": null,
        "matrikelnummer": "138o",
        "ejerlav_kode": 2006552,
        "ejerlav_navn": "Silkeborg Markjorder",
        "fredet": null,
        "fredningsstatus": null,
        "bevaringsvaerdi": null,
        "kommunekode": "0740",
        "antal_enheder": 0
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          9.5329415,
          56.157787
        ]
      },
      "properties": {
        "bfe_nummer": 5651067,
        "bygning_id": "901088f3-b4e8-4acf-98f7-c69389c3e56f",
        "bygningsnummer": 2,
        "anvendelse_kode": "920",
        "anvendelse": "Carport",
        "opfoerelsesaar": 2014,
        "om_tilbygningsaar": null,
        "antal_etager": null,
        "bebygget_areal_m2": 25,
        "samlet_bygningsareal_m2": null,
        "samlet_boligareal_m2": null,
        "ydervaeg": "Træ",
        "tag": "Tagpap med stor hældning",
        "varme": null,
        "opvarmningsmiddel": null,
        "matrikelnummer": "138o",
        "ejerlav_kode": 2006552,
        "ejerlav_navn": "Silkeborg Markjorder",
        "fredet": false,
        "fredningsstatus": "ingen_registrering",
        "bevaringsvaerdi": null,
        "kommunekode": "0740",
        "antal_enheder": 0
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          9.532961,
          56.1578452
        ]
      },
      "properties": {
        "bfe_nummer": 5651067,
        "bygning_id": "c7e65d4a-0c66-4838-9b19-728abbeddd71",
        "bygningsnummer": 1,
        "anvendelse_kode": "120",
        "anvendelse": "Fritliggende enfamiliehus",
        "opfoerelsesaar": 1958,
        "om_tilbygningsaar": null,
        "antal_etager": 1,
        "bebygget_areal_m2": 116,
        "samlet_bygningsareal_m2": 116,
        "samlet_boligareal_m2": 95,
        "ydervaeg": "Mursten",
        "tag": "Tegl",
        "varme": "Fjernvarme/blokvarme",
        "opvarmningsmiddel": null,
        "matrikelnummer": "138o",
        "ejerlav_kode": 2006552,
        "ejerlav_navn": "Silkeborg Markjorder",
        "fredet": false,
        "fredningsstatus": "ingen_registrering",
        "bevaringsvaerdi": null,
        "kommunekode": "0740",
        "antal_enheder": 1
      }
    }
  ],
  "numberMatched": 3,
  "numberReturned": 3,
  "crs": {
    "type": "name",
    "properties": {
      "name": "urn:ogc:def:crs:OGC:1.3:CRS84"
    }
  },
  "bbox": [
    9.5329415,
    56.157787,
    9.532961,
    56.1578452
  ]
}

Parametre

bfeintegerstipåkrævet
BFE-nummeret på den ejendom, hvis bygninger du vil have som GeoJSON.Eksempel: 5651067

Felter i svaret

features[].properties.bygning_idstring | null
BBR-bygningens id. Det er samme nøgle som bbr_uuid i GeoDanmark-omridsene.
features[].properties.anvendelsestring | null
Anvendelsen som tekst; koden står i anvendelse_kode.
features[].properties.fredetboolean | null
Fredning fra FBB. null betyder, at bygningen ikke kunne slås op — ikke at den er ufredet. Det samme gælder fredningsstatus og bevaringsvaerdi.
features[].properties.bevaringsvaerdiinteger | null
SAVE-bevaringsværdi 1-9, hvor 1 er højest. null når bygningen ikke er vurderet.
features[].geometryGeoJSON Point | null
Bygningens punkt i WGS84 [lon, lat] — ikke omridset.
bbox[minLon, minLat, maxLon, maxLat]
Udstrækningen af alle punkter. Mangler, når ingen bygning har et punkt.

Statuskoder

StatusBetydning
200Svaret er leveret.
400BFE-nummeret er ikke et positivt heltal.
401Nøglen mangler eller er ugyldig.
404BFE-nummeret findes ikke i BBR.
429Burst-grænsen eller månedskvoten er nået. Se Retry-After.
502Datafordeler svarede ikke, og der fandtes ingen cachet kopi.
503Kilden er ikke konfigureret 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

Demo-endpointet svarer med den samme rigtige ejendom, BFE 5651067 (Solbakkevej 70, 8600 Silkeborg), som FeatureCollection i samme form. BFE-nummeret i formularen bruges ikke.

GET /v1/demo/ejendom.geojson

Bruges ofte sammen med

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