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