Page History

Display Metadata

hidetableheader	true

Anchor

	Toppen
	Toppen

Siden beskriver de REST tjenester, der udstilles på Datafordeleren fra Danmarks Højdemodel (DHM).

Få en introduktion til REST på Datafordeleren, hvis du har brug for en introduktion til og vejledning i, hvordan man kan anvende webservices, som udstilles på Datafordeleren.

Få en guide til helt konkrete anvisninger til at bruge en webservice fra Datafordeleren i Guide til REST på Selvbetjeningen.

Table of Contents

Url opbygning for REST

Url for de enkelte services er opbygget af et endpoint efterfulgt af registernavn, servicenavn, versionen af servicen, servicetype (REST eller WFS etc.) samt metodenavn for REST services. Efter ? tilføjes parametre i kaldet, der kan indeholde generelle kaldeparametre for REST services og metode specifikke parametre.

Endpointet indeholder værtsnavnet, med et præfiks for miljøet hvis det ikke er produktionsmiljøet der tilgås. Hvis der er tale om fortrolige eller følsomme data, følger S5 og at servicen skal kaldes med certifikat derfor certservices - se miljøbeskrivelser.

Url-struktur for REST services	<endpoint>/register/service/version/servicetype/metode?
Eksempel	https://services.datafordeler.dk/DHMTerraen/DHMKoter/1.0.0/GEOREST/HentKoter?

Generelt for Danmarks Højdemodel (DHM) webservices

Registernavn i Selvbetjeningen	DHMTerraen
Format	XML/JSON
DLS version	1.5
Register	DHMterræn
Sikkerhedszone	0 – Indeholder ikke fortrolige eller følsomme data
Adgangsniveau	Kendt bruger – der skal oprettes en webbruger og tjenestebruger med brugernavn og adgangskode
Paging	Anvender ikke paging.

Til toppen

REST - DHMKoter

Beskrivelse

DHM/Koter er en digital gengivelse af terrænets højdeforhold. DHM/Koter er baseret på DHM/Terræn, hvor objekter såsom træer, huse, biler, m.m. er fjernet.

Tjenesten returnerer en kote for hvert geografiske punkt (plan koordinat), der er angivet i parameteren geop.

Der kan forespørges op til 50 geografiske punkter i en forespørgsel.

Responset skal sikre, at koterne returneres i samme rækkefølge som de geografiske punkter i forespørgslen. Fx hvis forespørgsel har punkterne geop=[geopktA,geopktB,geopktC] så skal responset være [geopktA+koteA,geopktB+koteB,geopktC+koteC], også selvom det ikke var muligt at finde en kote til et eller flere af punkterne. Er der til et geografisk punkt ingen kote, sættes koten til null. Der skal kunne returneres både JSON og XML.

Hvordan koterne hentes er op til leverandøren, men der findes i dag en tjeneste i Kortforsyningen der funktionelt kan det - se evt. https://kortforsyningen.dk/indhold/geonoegler-rest#geopmulti.

Eksempel på et GET kald til denne kan ses nedenfor.

Der er i eksemplet blot anvendt to geografiske punkter, men antallet af punkter kunne have været flere eller færre.

https://services.datafordeler.dk/DHMTerraen/DHMKoter/1.0.0/GEOREST/HentKoter?username=xxx&password=yyy&geop=POINT(550000 206221000);POINT(550000 206223000);POINT(550000 20622400098765)&georef=EPSG:25832&elevationmodel=dsm

Code Block

title	Eksempel på json respons
collapse	true

// 20201021110501
// https://services.datafordeler.dk/DHMTerraen/DHMKoter/1.0.0/GEOREST/HentKoter?username=xxx&password=yyy&geop=POINT(550000%206221000);POINT(550000%206223000);POINT(550000%20622400098765)&georef=EPSG:25832&elevationmodel=dsm

{
  "HentKoterRespons": {
    "georef": "EPSG:25832",
    "elevationmodel": "dsm",
    "data": [
      {
        "geop": "550000,6221000",
        "kote": 92.75602
      }
    ]
  }
}

Til toppen

Datagrundlaget	DHM/Terræn og DHM/overflade
SLA	Se registrets tilgængelighed på Datafordeler.dk

Metodeoversigt

Metode	SLA kategori	Tværgående tjeneste
HentKoter	Normal	Nej

SLA kategorier i produktion- maksimal svartid i sekunder:

Simpel: 0.09
Normal: 1.0
Kompleks: 2.5

Til toppen

Url

https://services.datafordeler.dk/DHMTerraen/DHMKoter/1.0.0/GEOREST/HentKoter?

Inputparametre

Navn

Type

Beskrivelse

Default værdi

georef

String

Projektion som geop punkter er angivet i. Mulige værdier er EPSG:25832 og EPSG:4326. Parameteren angives 0 eller 1 gang. Det betyder, at når der angives flere geografiske punkter i geop, så antages det at alle disse er i samme projektion.

EPSG:25832

geop

String/Array

Geografisk position i form af en eller flere koordinater. Hvert koordinat angives som easting,northing eller breddegrad,længdegrad (lat,lon) med værdier jf. parameteren georef. Decimaler angives med punktum. Flere koordinater anvendes i en array struktur v. POST, ellers bruges ; som separator i GET forespørgsler.

Maks. 50 punkter.

obligatorisk

elevationmodel

String

an antage værdien 'dtm' for terrænmodel data eller 'dsm' for overflademodel data. Default værdien hvis parameteren udelades er 'dtm'

dtm

Code Block

language	js
title	Svar
collapse	true

{
    "HentKoterRespons": {
        "georef": "EPSG:25832",
        "elevationmodel": "dtm",
        "data": [
            {
                "geop": "720000,6200000",
                "kote": 29.750881
            }
        ]
    }
}

Code Block

language	js
title	Svar
collapse	true

{
    "HentKoterRespons": {
        "georef": "EPSG:25832",
        "elevationmodel": "dtm",
        "data": [
            {
                "geop": "720000,6200000",
                "kote": 29.750881
            },
            {
                "geop": "550000,6223000",
                "kote": 76.966393
            }
        ]
    }
}

Info

icon	false
title	URL

https://services.datafordeler.dk/DHMTerraen/DHMKoter/1.0.0/GEOREST/HentKoter?format=json&username=xxx&password=yyy&geop=POINT(720000.0 6200000.0)|POINT(550000 6223000)&elevationmodel=dsm

Code Block

language	js
title	Svar
collapse	true

{
    "HentKoterRespons": {
        "georef": "EPSG:25832",
        "elevationmodel": "dsm",
        "data": [
            {
                "geop": "720000,6200000",
                "kote": 35.264359
            },
            {
                "geop": "550000,6223000",
                "kote": 76.966393
            }
        ]
    }
}

Code Block

language	js
title	Svar
collapse	true

{
    "HentKoterRespons": {
        "georef": "EPSG:4326",
        "elevationmodel": "dtm",
        "data": [
            {
                "geop": "55.455779,10.178309",
                "kote": 41.946392
            }
        ]
    }
}
{

Info

icon	false
title	URL

https://services.datafordeler.dk/DHMTerraen/DHMKoter/1.0.0/GEOREST/HentKoter?username=xxx&password=yyy&geop=POINT(550000 206221000)|POINT(550000 206223000)|POINT(550000 20622400098765)&georef=EPSG:25832&elevationmodel=dsm

Code Block

language	js
title	Svar
collapse	true

{
  "HentKoterRespons": {
    "georef": "EPSG:25832",
    "elevationmodel": "dsm",
    "data": [
      {
        "geop": "550000,6221000",
        "kote": 92.75602
      }
    ]
  }
}

Page tree

Versions Compared

Old Version 5

New Version 6

Key

Generelt for Danmarks Højdemodel (DHM) webservices

REST - DHMKoter

Metode - HentKoter

Eksempler

Eksempel 1 - Hent koter

Eksempel 2 - Hent flere koter med seperator

Eksempel 3 - Hent koter med elevationmodel

Eksempel 4 - Hent koter med georef

Eksempel 5 - Hent koter med georef, seperator og elevationmodel