# Bygningsomrids for en ejendom

`GET /v1/geodanmark/bygninger/:bfe` · GeoDanmark

De rigtige bygningsomrids fra GeoDanmark som WGS84-polygoner for hver bygning på en ejendom, dér hvor BBR kun har et punkt.

BBR registrerer kun ét punkt pr. bygning. Endpointet slår ejendommens bygninger op i BBR og henter deres omrids fra GeoDanmark, koblet på BBR-bygningens id (`bbr_uuid`). Bygninger, som GeoDanmark ikke har koblet til BBR, findes i stedet ud fra deres BBR-punkt.

Hvert omrids er en eller flere ydre ringe i WGS84 `[lon, lat]` — flere, når bygningen består af flere dele. Formen er den samme som jordstykkets omrids fra [Matriklen](https://grundfast.dk/docs/api/matrikel-ejendom), så du kan tegne begge med samme kode.

En tom `buildings` er et gyldigt svar: ejendommen findes, men ingen af dens bygninger har et digitaliseret omrids endnu. Ikke alle bygninger på en ejendom er nødvendigvis med.

**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 bygningsomrids du vil have. |

## Eksempel

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

## Svar (200)

```json
{
  "bfe_nummer": 5651067,
  "buildings": [
    {
      "bbr_uuid": "901088f3-b4e8-4acf-98f7-c69389c3e56f",
      "rings": [
        [
          [9.533001, 56.157792],
          [9.532996, 56.157792],
          [9.532947, 56.157799],
          [9.532938, 56.157781],
          [9.533062, 56.157764],
          [9.533075, 56.157793],
          [9.533006, 56.157803],
          [9.533001, 56.157792]
        ]
      ]
    },
    {
      "bbr_uuid": "c7e65d4a-0c66-4838-9b19-728abbeddd71",
      "rings": [
        [
          [9.532798, 56.157905],
          [9.53277, 56.157842],
          [9.532825, 56.157834],
          [9.532817, 56.157817],
          [9.532919, 56.157803],
          [9.532947, 56.157799],
          [9.532996, 56.157792],
          [9.533001, 56.157792],
          [9.533006, 56.157803],
          [9.533039, 56.157877],
          [9.533029, 56.157878],
          [9.533037, 56.157895],
          [9.532964, 56.157905],
          [9.532956, 56.157889],
          [9.532855, 56.157903],
          [9.532853, 56.157897],
          [9.532798, 56.157905]
        ]
      ]
    }
  ],
  "attribution": "@geodanmark",
  "meta": {
    "kilde": "GeoDanmark via Grundfast",
    "grundfast_version": "0.1.0"
  }
}
```

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `buildings[].bbr_uuid` | string | BBR-bygningens id — samme værdi som `bygninger[].id` fra [Hent en ejendom](https://grundfast.dk/docs/api/bbr-ejendom). Brug det til at koble omridset til BBR-oplysningerne. |
| `buildings[].rings` | [lon, lat][][] | Bygningens ydre ring(e) i WGS84. Mere end én ring betyder en bygning i flere dele. |
| `attribution` | string | GeoDanmark-data er CC BY 4.0. Vis denne kreditering (`@geodanmark`), hvor du tegner omridsene. |

## 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 | BBR eller GeoDanmark svarede ikke, og der fandtes ingen cachet kopi. |
| 503 | GeoDanmark er ikke konfigureret i dette miljø. |

> GeoDanmark-data er licenseret under CC BY 4.0. Krediteringen i `attribution` skal vises, hvor omridsene bruges.