Bygningsomrids for en ejendom

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

GEThttps://api.grundfast.dk/v1/geodanmark/bygninger/{bfe}

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

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

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/geodanmark/bygninger/5651067" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

Svar · fra demo-endpointet200json

{
  "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"
  }
}

Parametre

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

Felter i svaret

buildings[].bbr_uuidstring: BBR-bygningens id — samme værdi som bygninger[].id fra Hent en 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.
attributionstring: GeoDanmark-data er CC BY 4.0. Vis denne kreditering (@geodanmark), hvor du tegner omridsene.

Statuskoder

Status	Betydning
200	Svaret er leveret.
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ø.

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

Prøv det

Live-kald fra siden

Bruges ofte sammen med

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

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

Svar · demo200json

{
  "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"
  }
}