Dokumentation af geonøgler Classic - Kortforsyningen

Kort & Matrikelstyrelsen
Kortforsyningen Version 2.13, 2010-05-21
· geoE (Ejerlavskode for et given ejerlavsnavn)
· geoKE (Alle ejerlav i en kommune)
· geoO (Matrikelnummer og ejerlavskode for en given position)
· geoT (transformation af koordinater fra en projektion/datum til en anden)
Man opnår adgang til Geonøglerne via Internettet. På den måde kan man nemmere udvikle
løsninger, der integrerer både kort og fx adresser fra Kortforsyningen®. Dette dokument
indeholder informationer om hvordan man kan benytte Geonøglerne.
Hvordan fungerer Kortforsyningens Geonøgler?
Kortforsyningens Geonøgler er en service, der via Internettet kan returnere informationer i ASCII,
XML eller HTML tekstformat. Indholdet af teksten kan være positioner for en forespurgt lokalitet i
form af en adresse, et matrikelnummer eller et stednavn. Det er også muligt at transformere
koordinater fra en projektion/datum til en anden projektion/datum. Den returnerede tekst vil så
indeholde værdier for de transformerede koordinater.
Man benytter Geonøglerne ved at lave en forespørgsel (efterfølgende kaldet et http request) vha.
en URL. En URL er groft sagt adressen på en web-side fx
http://kortforsyningen.kms.dk/default.htm. Et http request finder sted hver gang man fx indtaster
en URL i en browser eller klikker på et hyperlink på en web-side. Efter man har lavet et http
request sendes et svar (efterfølgende kaldet et respons) retur til Internet-browseren på den
maskine hvorfra requestet kom. Dette respons afhænger af det forespurgte dokument (http
requestet). Servicen kan give et respons som er formateret som ASCII, XML eller HTML. Hvilket
format man vælger afhænger af, hvad der er bedst til ens pågældende applikation.
Man skal selv opbygge URLen da den indeholder informationer om fx det stednavn, der søges og
hvilket format, der ønsket returneret. Med HTML, ASP, PHP, JavaScript og/eller Java er det nemt
at gøre dette. Ønsker man at lave en forespørgsel på et stednavn og dermed få returneret bl.a.
positionen for dette stednavn (hvis det findes) kunne URLen se således ud:
http://kortforsyningen.kms.dk/service?ServiceName=geoS&soegemetode=2&stednavn=ager&amt
skode=-1&kommunekode=-
1&format=ASCII&exceptionss=xml&max_hits=5&login=xxx&password=xxx
URLen består indtil spørgsmålstegnet (?) blot af URL prefixet til den web-side, der returnerer
positionen på stednavnet. Efter spørgsmålstegnet ? kommer parametrene, der består af et
parameternavn og dens tilhørende værdi. Parameternavnet og værdien er adskilt med et =.
Parametrene er altid adskilt med et &. I URLen nedenfor er parametrene servicename og
stednavn markeret med gult. Den første af de to parametre har altså navnet servicename og
værdien ager.
http://kortforsyningen.kms.dk/service?servicename=geoS&stednavn=ager&soegemetode=2&max
_hits=5&format=ASCII&exceptions=XML&login=xxx&password=xxx
Parametre og værdier kan ændres alt afhængig af hvad man ønsker returneret. I ovenstående
tilfælde vil URLen medfører at der søges efter stednavne hvori ager indgår og returnere
maksimalt fem resultater i ASCII format. Den returnerede tekst vil se således ud (teksten kan
variere i henhold til dataene i databasen):
HEADER: antal forekomster 5#FOREKOMST 1;Amager
Fælled;101;København;1013;Københavns
Kommune;UTM32_EUREF89;6172454;725017;FOREKOMST 2;Stenagergård;169;Høje-
Tåstrup;1015;København;UTM32_EUREF89;6175209;708025;FOREKOMST
3;Agershvile;181;Søllerød;1015;København;UTM32_EUREF89;6193232;723038;FOREKOMST
4;Amager Skov;185;Tårnby;1015;København;UTM32_EUREF89;6171188;736072;FOREKOMST
5;Højsager;208;Fredensborg-
Humlebæk;1020;Frederiksborg;UTM32_EUREF89;6208449;715261#COPYRIGHT Kort &
Matrikelstyrelsen
Ved at ændre en eller flere af parameterværdierne, og dermed ændre requestet, vil responset
tilsvarende ændres. Ændres værdien af parameteren servicename til geoA vil der i stedet
Side 5 af 94