Spring til indhold

Grundfast

Hent bygningshøjder

Den målte højde og tagform for hver bygning på en ejendom, målt inden for bygningens GeoDanmark-omrids.

GET/v1/dhm/bygninger/{bfe}

Bygningerne er de samme GeoDanmark-omrids, som /v1/geodanmark/bygninger/:bfe returnerer. Højden måles fra højdemodellens celler inden for omridset: tag_m er 95-percentilen af overfladen (så et træ, der hænger ind over, ikke bliver til tag), terraen_m er medianen af terrænet, og hoejde_m er forskellen. Alle koter er i DVR90.

Intet tal er afledt af BBR’s etageantal. En bygning har enten en måling eller hoejde_m: null med en aarsag, fx ingen_geometri (intet omrids i GeoDanmark) eller upstream_fejl. ufuldstaendig: true betyder, at mindst én bygning mangler en måling.

tag er en tagflade tilpasset de samme celler: form (fladt, ensidig, saddeltag eller valm), kipretning, hældning og tagfod. Kan formen ikke bestemmes sikkert, er tagform null med en aarsag. konfidens er en heuristisk score fra 0 til 1, ikke en sandsynlighed.

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, uanset antallet af bygninger.

Eksempel

curl "https://api.grundfast.dk/v1/dhm/bygninger/5651067" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
Svar · eksempel200
{
  "bfe_nummer": 5651067,
  "system": "DVR90",
  "metode": {
    "tag": "p95",
    "terraen": "median",
    "hoejde": "tag_m - terraen_m",
    "tagflade": "ransac_planfit"
  },
  "antal": 2,
  "bygninger": [
    {
      "bbr_uuid": "0a3f509b-1c2d-32b8-e044-0003ba298018",
      "hoejde_m": 8.62,
      "hoejde_maalt": true,
      "hoejde_kilde": "DHM",
      "tag_m": 21.84,
      "tag_middel_m": 19.7,
      "terraen_m": 13.22,
      "terraen_min_m": 13.05,
      "terraen_max_m": 13.41,
      "antal_celler": 912,
      "celle_m": 0.4,
      "aarsag": null,
      "tag": {
        "tagform": "saddeltag",
        "kip_retning_grader": 88.4,
        "fald_retning_grader": 178.9,
        "haeldning_grader": 38.6,
        "tagfod_m": 3.9,
        "konfidens": 0.87,
        "antal_celler": 804,
        "aarsag": null
      }
    },
    {
      "bbr_uuid": "0a3f509b-1c2d-32b8-e044-0003ba298019",
      "hoejde_m": 2.71,
      "hoejde_maalt": true,
      "hoejde_kilde": "DHM",
      "tag_m": 15.98,
      "tag_middel_m": 15.83,
      "terraen_m": 13.27,
      "terraen_min_m": 13.19,
      "terraen_max_m": 13.34,
      "antal_celler": 21,
      "celle_m": 0.4,
      "aarsag": null,
      "tag": {
        "tagform": null,
        "kip_retning_grader": null,
        "fald_retning_grader": null,
        "haeldning_grader": null,
        "tagfod_m": null,
        "konfidens": 0,
        "antal_celler": 0,
        "aarsag": "for_faa_celler"
      }
    }
  ],
  "ufuldstaendig": false,
  "attribution": "@geodanmark",
  "meta": {
    "kilde": "Dataforsyningen DHM + GeoDanmark via Grundfast",
    "grundfast_version": "0.1.0"
  }
}

Parametre

bfeintegerstipåkrævet
BFE-nummeret (Bestemt Fast Ejendom) — ejendommens nøgle på tværs af BBR, Matriklen og vurderingen.Eksempel: 5651067

Felter i svaret

bygninger[].hoejde_mnumber | null
Bygningens højde over terræn i meter (tag_m − terraen_m). null når den ikke kunne måles — aldrig 0.
bygninger[].aarsagstring | null
Hvorfor hoejde_m er null: ingen_geometri, ingen_data, upstream_fejl, uden_for_budget eller negativ_hoejde.
bygninger[].terraen_min_m / terraen_max_mnumber | null
Laveste og højeste terrænkote under omridset — faldet under bygningen.
bygninger[].tag.tagformstring | null
Den målte tagform, eller null med tag.aarsag, når målingen ikke bærer en form.
bygninger[].tag.haeldning_gradernumber | null
Taghældning i grader fra vandret, som et gennemsnit over de flader, der definerer formen.
ufuldstaendigboolean
Sand, når mindst én bygning mangler en målt højde. Se aarsag pr. bygning.
attributionstring
Kreditering for GeoDanmark-omridsene (CC BY 4.0). Vis den, hvor omridsene tegnes.

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.
502GeoDanmark-omridsene kunne ikke hentes, eller højdemodellen kunne ikke nås for nogen af bygningerne. En delvis fejl er en 200 med aarsag: "upstream_fejl" på de berørte bygninger.
503DHM- eller GeoDanmark-kilden 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

Kræver din nøgle

Nøglen bliver i denne fane og sendes kun til grundfast.dk. Kaldet tæller som et almindeligt kald — brug en gf_test_-nøgle for at prøve gratis. Opret en gratis nøgle

GET /v1/dhm/bygninger/5651067

Bruges ofte sammen med

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