Hent højden i et punkt
Terræn- og overfladekote i ét WGS84-punkt fra Danmarks Højdemodel, i meter DVR90.
https://api.grundfast.dk/v1/dhm/punktSvaret har to koter: terraen_m fra terrænmodellen (jorden) og overflade_m fra overflademodellen (med bygninger og beplantning). Forskellen mellem dem er fx højden af det, der står i punktet.
Hver kote følges af sin kvalitet: højdesystem (DVR90), rastercelle, udtagningsmetode og modellens nøjagtighed. Det står i selve svaret, så tallet kan skrives direkte på en tegning uden at skulle forklares bagefter. Koordinaten ekkoes i punkt og reprojiceret i epsg25832.
adgangsadresse_id fra /v1/adresse/search i stedet for lon/lat, eller bfe for et punkt inde på grunden; svaret viser i opslag, hvor koten er målt. Guiden Find terrænhøjden for en adresse viser også vejen uden kode.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/dhm/punkt?lon=9.9147&lat=56.031834" \
-H "Authorization: Bearer $GRUNDFAST_API_KEY"{
"punkt": {
"lon": 9.9147,
"lat": 56.031834
},
"epsg25832": [
557000.03,
6209999.99
],
"terraen_m": 23.9,
"overflade_m": 35.93,
"system": "DVR90",
"system_epsg": 5799,
"oploesning_m": 0.4,
"metode": "naermeste_celle",
"usikkerhed_m": 0.05,
"meta": {
"kilde": "Dataforsyningen DHM via Grundfast",
"grundfast_version": "0.1.0"
}
}Parametre
lonnumberquerypåkræveteller x/y, adgangsadresse_id eller bfe- Længdegrad i WGS84 (decimalgrader). Påkrævet, medmindre
xogyer sendt.Eksempel:9.9147 latnumberquerypåkræveteller x/y, adgangsadresse_id eller bfe- Breddegrad i WGS84 (decimalgrader). Påkrævet, medmindre
xogyer sendt.Eksempel:56.031834 xnumberqueryvalgfri- DAWA-kompatibel østkoordinat eller længdegrad, sammen med
yogsrid. ynumberqueryvalgfri- DAWA-kompatibel nordkoordinat eller breddegrad, sammen med
xogsrid. sridstringqueryvalgfri- Koordinatsystem for
x/y:4326(WGS84) eller25832(ETRS89/UTM32N i meter).Standard:4326Værdier:432625832 adgangsadresse_idstring (UUID)queryvalgfri- I stedet for en koordinat: adressens id fra
/v1/adresse/search. Koten måles i adressepunktet — samme punkt som søgningenskoordinat. Et enhedsadresse-id slås op på sin adgangsadresse. bfeintegerqueryvalgfri- I stedet for en koordinat: ejendommens BFE-nummer. Koten måles i et punkt inde på ejendommens jordstykke — ikke ved adressen, så tallet kan afvige fra adressepunktets på en skrånende grund.
Felter i svaret
terraen_mnumber | null- Terrænkote (DTM) i meter DVR90.
nullbetyder, at modellen ikke har data i punktet — typisk fordi punktet ligger uden for dens dækning: i udlandet (fx Flensborg eller Lund) eller på åbent hav. Aldrig 0, som er en realistisk kote ved kysten. overflade_mnumber | null- Overfladekote (DSM) i meter DVR90, inklusive bygninger og beplantning.
nullaf samme grunde somterraen_m. Brugterraen_mtil alt, der måles fra jorden. system"DVR90"- Højdesystemet for alle meterværdier i svaret;
system_epsger 5799. oploesning_mnumber- Størrelsen på den rastercelle, værdien er læst fra.
0.4er modellens egen opløsning. metode"naermeste_celle"- Værdien er cellen, koordinaten falder i — ikke interpoleret.
usikkerhed_mnumber | null- Modellens specificerede lodrette nøjagtighed (0,05 m) for produktet som helhed, ikke en fejlmargin for netop dette punkt. Under træer og over vand er usikkerheden større.
null, når der ingen kote er. opslag{ type, adgangsadresse_id | bfe_nummer }- Kun når du sendte
adgangsadresse_idellerbfe: hvilket punkt koten er målt i —type: "adgangsadresse"(adressepunktet) ellertype: "ejendom"(et punkt inde på jordstykket).
Statuskoder
| Status | Betydning |
|---|---|
| 200 | Svaret er leveret. |
| 400 | Koordinaten mangler, er ikke et tal, ligger uden for Danmark, eller srid er andet end 4326 og 25832. |
| 401 | Nøglen mangler eller er ugyldig. |
| 429 | Burst-grænsen eller månedskvoten er nået. Se Retry-After. |
| 502 | Højdemodellen kunne ikke nås. Rapporteres aldrig som en kote på 0 eller null. |
| 503 | DHM-kilden er ikke konfigureret i dette miljø. |
Alle fejl har samme form. Byg logikken på type (fejlklassen) og vis message (dansk tekst med årsagen) til brugeren; hint kommer med, når vi kan se, hvad der skal rettes, og request_id er det, support skal bruge. Se Fejl og statuskoder for hver type, og hvad der kan prøves igen.
{
"error": "property not found",
"type": "not_found",
"code": "not_found",
"message": "Ressourcen findes ikke.",
"request_id": "6cbfa45a-a9ea-4140-9d42-ea752a70ff1f",
"doc_url": "https://grundfast.dk/docs/fejl#not_found"
}Prøv det
Live-kald fra siden
Bruges ofte sammen med
- GETHent en terrænkote
/v1/dhm /kote - GETHent et terrænprofil
/v1/dhm /profil - GETHent bygningshøjder
/v1/dhm /bygninger /:bfe
Læs mere om DHM, og hvad data kan bruges til, på produktsiden.