# Bygningerne som GeoJSON

`GET /v1/bbr/ejendom/:bfe/geojson` · BBR

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

Samme data som [Hent en ejendom](https://grundfast.dk/docs/api/bbr-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:** `Authorization: Bearer gf_live_…` (eller `gf_test_…`)

**Afregning:** Ét kald.

## Parametre

| Navn | Placering | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- | --- |
| `bfe` | path | integer | ja | BFE-nummeret på den ejendom, hvis bygninger du vil have som GeoJSON. |

## Eksempel

```bash
curl "https://api.grundfast.dk/v1/bbr/ejendom/5651067/geojson" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
```

## Svar (200)

```json
{
  "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
  ]
}
```

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `features[].properties.bygning_id` | string \| null | BBR-bygningens id. Det er samme nøgle som `bbr_uuid` i [GeoDanmark-omridsene](https://grundfast.dk/docs/api/geodanmark-bygninger). |
| `features[].properties.anvendelse` | string \| null | Anvendelsen som tekst; koden står i `anvendelse_kode`. |
| `features[].properties.fredet` | boolean \| 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.bevaringsvaerdi` | integer \| null | SAVE-bevaringsværdi 1-9, hvor 1 er højest. `null` når bygningen ikke er vurderet. |
| `features[].geometry` | GeoJSON 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. |

## Fejl

| Status | Betydning |
| --- | --- |
| 400 | BFE-nummeret er ikke et positivt heltal. |
| 401 | Nøglen mangler eller er ugyldig. |
| 404 | BFE-nummeret findes ikke i BBR. |
| 429 | Burst-grænsen eller månedskvoten er nået. Se `Retry-After`. |
| 502 | Datafordeler svarede ikke, og der fandtes ingen cachet kopi. |
| 503 | Kilden er ikke konfigureret i dette miljø. |