Dokumentation af geonøgler Classic - Kortforsyningen
Dokumentation af geonøgler Classic - Kortforsyningen
Dokumentation af geonøgler Classic - Kortforsyningen
You also want an ePaper? Increase the reach of your titles
YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.
Kort & Matrikelstyrelsen<br />
<strong>Kortforsyningen</strong> Version 2.13, 2010-05-21<br />
forespørges på positionen for en adresse i stedet for positionen for et stednavn. På samme måde<br />
kan værdien <strong>af</strong> parameteren stednavn i URLen ovenover ændres til Virum, hvis positionen for<br />
Virum ønskes returneret.<br />
Rækkefølgen <strong>af</strong> parametrene er vilkårlig. Der vil derfor ikke være forskel på de to<br />
nedenstående eksempler:<br />
http://kortforsyningen.kms.dk/service?servicename=geoS&stednavn=næstved&soegemetode=0&<br />
max_hits=10&format=XML&exceptions=XML&login=xxx&password=xxx<br />
http://kortforsyningen.kms.dk/service?stednavn=næstved&soegemetode=0&servicename=geoS&<br />
max_hits=10&format=XML&exceptions=XML&login=xxx&password=xxx<br />
Parameterværdier er case-sensitive, med mindre andet er nævnt, mens parameternavnene er<br />
case-insensitive. Der vil derfor være forskel på SERVICENAME=geoS og SERVICENAME=geos.<br />
Omvendt er der ingen forskel på SERVICENAME=geoS og ServiceName=geoS.<br />
Parameterværdier, der ikke er case-sensitive , vil fremgå senere i dette dokument.<br />
Parameteren ServiceName er altid nødvendig, uanset hvilken geonøgle, der anvendes. For de<br />
enkelte geonøgler er der desuden yderlige nødvendige og valgfrie parametre. At der er valgfrie<br />
parameter skyldes, at de har en standardværdi. Det betyder, at angives parameteren ikke i<br />
URLen, så vil standardværdien benyttes for den pågældende parameter. Et eksempel er<br />
parameteren FORMAT, der har standardværdien ASCII.<br />
Http forespørgselstype og URL encoding<br />
Forespørgsler til <strong>Kortforsyningen</strong> kan gøres ved hjælp <strong>af</strong> både post og get metoderne. Ved<br />
get angives parametrene i adressen (URLen) som beskrevet ovenfor. Ved post sendes<br />
parametrene skjult i selve HTTP-forespørgslen. Post opbygges typisk ved hjælp <strong>af</strong> formular-felter<br />
() med typen action=post.<br />
Benytter man get-metoden anbefales det for visse <strong>af</strong> geonøglerne at URL encode dele <strong>af</strong> URL'en<br />
før sendes mod <strong>Kortforsyningen</strong>. Ved brug <strong>af</strong> geoVA er det påkrævet at URL encode værdien<br />
<strong>af</strong> parameteren multi. URL encoding betyder blot at visse tegn i URL'en erstattes med en kode<br />
startende med % efterfulgt <strong>af</strong> en hexadecimal tal. Disse tegn er typisk ikke-latinske tegn fx<br />
mellemrum og semikolon samt tegn med en regional tilknytning fx æ, ø og å. Nedenfor er vist to<br />
eksempler på en streng før og efter URL encoding.<br />
Før: Hello World!<br />
Efter: Hello%20World%21<br />
Før: http://kortforsyningen.kms.dk/service?servicename=geoS&stednavn=hærup&...<br />
Efter: http://kortforsyningen.kms.dk/service?servicename=geoS&stednavn=h%E6rup&...<br />
Der findes metoder til URL encoding i de fleste script- og programmeringssprog. Nedenfor er vist<br />
nogle eksempler.<br />
JavaScript<br />
var myURLEncodedString = escape("Hello World!");<br />
ASP/VBScript<br />
Dim myURLEncodedString<br />
myURLEncodedString = Server.URLEncode("Hello World!")<br />
Det anbefales at URL encode alle parametre, der kan indeholde specielle tegn som æ, ø, å,<br />
mellemrum og semikolon. Det er fx parametre som stednavn i geoS og vejnavn i geoV. Bruger<br />
man metoden post behøver man ikke gøre noget, da metoden selv automatisk URL<br />
encoder.<br />
Side 6 <strong>af</strong> 94