REST (DHM)

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.

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.

Generelt for Danmarks Højdemodel (DHM) webservices

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

// 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
      }
    ]
  }
}

Metodeoversigt

SLA kategorier i produktion- maksimal svartid i sekunder:

• Simpel: 0.09
• Normal: 1.0
• Kompleks: 2.5

Metode - HentKoter

Url

Inputparametre