Spring til indhold

Grundfast

Hent en terrænkote

Terrænkoten i DVR90 til en situationsplan — samme svar som /v1/dhm/punkt under det navn, tegningen bruger.

GET/v1/dhm/kote

Endpointet deler implementering med /v1/dhm/punkt, så de to kan ikke give forskellige tal. Det findes, fordi en situationsplan spørger efter en terrænkote, og den, der udfylder feltet, skal ikke lede efter den under et endpoint, der hedder "punkt".

En kote uden højdesystem kan kommunen ikke kontrollere, så system: "DVR90" og system_epsg: 5799 er altid med, sammen med opløsning, metode og nøjagtighed. Et punkt uden data er null, aldrig 0; en utilgængelig model er en 502.

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/kote?lon=9.9147&lat=56.031834" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
Svar · fra demo-endpointet200
{
  "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

lonnumberqueryvalgfri
Længdegrad i WGS84 (decimalgrader). Påkrævet, medmindre x og y er sendt.Eksempel: 9.9147
latnumberqueryvalgfri
Breddegrad i WGS84 (decimalgrader). Påkrævet, medmindre x og y er sendt.Eksempel: 56.031834
xnumberqueryvalgfri
DAWA-kompatibel østkoordinat eller længdegrad, sammen med y og srid.
ynumberqueryvalgfri
DAWA-kompatibel nordkoordinat eller breddegrad, sammen med x og srid.
sridstringqueryvalgfri
Koordinatsystem for x/y: 4326 (WGS84) eller 25832 (ETRS89/UTM32N i meter).Standard:4326Værdier:432625832

Felter i svaret

terraen_mnumber | null
Terrænkote (DTM) i meter DVR90. null betyder, 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. null af samme grunde som terraen_m. Brug terraen_m til alt, der måles fra jorden.
system"DVR90"
Højdesystemet for alle meterværdier i svaret; system_epsg er 5799.
oploesning_mnumber
Størrelsen på den rastercelle, værdien er læst fra. 0.4 er 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.

Statuskoder

StatusBetydning
200Svaret er leveret.
400Koordinaten mangler, er ikke et tal, ligger uden for Danmark, eller srid er andet end 4326 og 25832.
401Nøglen mangler eller er ugyldig.
429Burst-grænsen eller månedskvoten er nået. Se Retry-After.
502Højdemodellen kunne ikke nås. Rapporteres aldrig som en kote på 0 eller null.
503DHM-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

Demo-endpointet svarer altid med det samme offline-punkt (9.9147, 56.031834) i præcis samme form. Koordinaten i formularen bruges ikke.

GET /v1/demo/dhm

Bruges ofte sammen med

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