DHM-API — terræn- og overfladehøjde ved punkt over Dataforsyningen
DHM (Danmarks Højdemodel) er Register #4 i Grundfast: terræn- og overfladehøjde (DTM/DSM) for et koordinat, meter over DVR90, slået op i ét kald — WGS84 ind, intet højdemodel-grid at hoste selv. Det er live nu over Dataforsyningen DHM-WCS’en — demo og datakontrakt kan du teste uden nøgle.
GET /v1/dhm/punktHvad DHM-API’et giver dig
Terræn- og overfladehøjde i ét kald
Både terrænhøjde (DTM, bar jord) og overfladehøjde (DSM, inkl. bygninger og vegetation) for samme koordinat — i ét opslag, meter over DVR90.
Objekthøjde = differensen
Overflade minus terræn giver objekthøjden — fx bygnings- eller træhøjde — uden et ekstra opslag eller et eget højdemodel-grid at hoste.
Punktopslag i WGS84
Send lon/lat i WGS84; vi reprojicerer internt til EPSG:25832 og slår op i DHM-griddet. Ingen EPSG-jonglering og intet projektionslag i din kode.
Samme stabile cache/SLA-lag
DHM-WCS’en er vægelsindet. Grundfast lægger det samme cache- og SLA-lag oven på den, som du kender fra BBR og Matriklen — så et punktopslag svarer forudsigeligt.
Kald DHM i din stack
Endpointet er GET /v1/dhm/punkt?lon=&lat= med en gf_live_-nøgle — samme auth og metering som de øvrige registre. Send lon/lat i WGS84; samme punktopslag i cURL, TypeScript og Python:
curl -H "Authorization: Bearer gf_live_…" \ "https://api.grundfast.dk/v1/dhm/punkt?lon=12.5683&lat=55.6761"
Status & datakontrakt
Endpointet er GET /v1/dhm/punkt?lon=&lat= med samme nøgle, auth og metering som BBR og Matriklen — med en burst-grænse pr. nøgle, fordi hvert kald rammer den live DHM-WCS upstream. Et gyldigt punkt uden dækning svarer 200 med null; upstream-fejl svarer 502. Demo-datakontrakten har den endelige form:
# Live nu — Register #4 (Bearer gf_live_…): GET /v1/dhm/punkt?lon=12.5683&lat=55.6761 → 200 { punkt: { lon: 12.5683, lat: 55.6761 }, epsg25832: [725483.12, 6177378.45], terraen_m: 2.41, overflade_m: 14.87, meta: { kilde: "Dataforsyningen DHM via Grundfast", grundfast_version: "0.1.0" } } # objekthøjde = overflade_m − terraen_m ≈ 12.46 m (fx bygning) # Gyldigt punkt uden dækning (fx på havet) → 200 med null: → 200 { …, terraen_m: null, overflade_m: null, … } # Demo-datakontrakten virker uden nøgle: GET /v1/demo/dhm → 200 { punkt, epsg25832, terraen_m, overflade_m, meta }
/v1/dhm/punkt?lon=&lat=lon/lat i WGS84 → terraen_m og overflade_m i meter over DVR90. Klar at kalde nu.
/v1/demo/dhmDemo-datakontrakten i den endelige form — virker uden nøgle.
Kom i gang med DHM
Opret en gf_live_-nøgle i dashboardet og kald /v1/dhm/punkt?lon=12.5683&lat=55.6761. Spørgsmål om dækning eller burst-grænser? Skriv til os.
Se også Matrikel-API’et (Register #2) og DAGI-API’et (Register #3), eller hvorfor Grundfast er et Datafordeler-alternativ. Live-status ser du på status & oppetid.
Ofte stillede spørgsmål
Er DHM-API’et live nu?
Ja. GET /v1/dhm/punkt?lon=&lat= er live som Register #4 — kørt over Dataforsyningen DHM-WCS’en (coverages dhm_terraen + dhm_overflade). Demo (/v1/demo/dhm) virker uden nøgle. Endpointet svarer kun 503, hvis en deployment ikke har DHM-kilden konfigureret — det er ikke tilfældet i prod.
Hvad er forskellen på terraen_m og overflade_m?
terraen_m er terrænhøjden (DTM, den bare jord) i meter over DVR90, og overflade_m er overfladehøjden (DSM), som inkluderer bygninger og vegetation. Differensen overflade_m minus terraen_m svarer til objekthøjden på punktet — fx en bygnings- eller træhøjde — så du får den uden et ekstra opslag.
Hvilke koordinater skal jeg sende, og hvad sker der uden for Danmark?
Send lon/lat i WGS84 (lon ~7–16, lat ~54–58). Mangler en parameter, eller ligger punktet uden for Danmark, svarer endpointet 400. Et gyldigt punkt uden dækning — fx på havet — svarer 200 med terraen_m og overflade_m sat til null. Fejler DHM-WCS’en upstream, får du 502. Vi reprojicerer internt til EPSG:25832, så du selv slipper for EPSG-håndtering.
Hvad koster DHM-opslag?
DHM kører på den fælles selvbetjente prismodel (Free / Starter / Pro / Scale) med samme nøgle og metering som BBR, Matriklen og DAGI. Se priser for kald-inkluderet og overforbrug.
Er Grundfast officielt / tilknyttet SDFI?
Nej. Grundfast er et uafhængigt compatibility-lag — uofficielt, men det virker. DHM-data stammer fra Dataforsyningen / SDFI (CC BY 4.0); vi krediterer kilden.
Højder for hvert punkt i Danmark
Danmarks Højdemodel — terræn- og overfladehøjde ved enhver koordinat i landet, fra det samme datasæt klimatilpasning og forsyning bygger på. Slå en højde op med lon/lat, hvor som helst i Danmark.