REST (DHM)

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.

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

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

Svar

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

Svar

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

Svar

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

Svar

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

Svar

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

Page tree

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