Dokumentation af geonÃ¸gler Classic - Kortforsyningen

More documents

Recommendations

Info

Kort & Matrikelstyrelsen Kortforsyningen Version 2.13, 2010-05-21 forespørges på positionen for en adresse i stedet for positionen for et stednavn. På samme måde kan værdien af parameteren stednavn i URLen ovenover ændres til Virum, hvis positionen for Virum ønskes returneret. Rækkefølgen af parametrene er vilkårlig. Der vil derfor ikke være forskel på de to nedenstående eksempler: http://kortforsyningen.kms.dk/service?servicename=geoS&stednavn=næstved&soegemetode=0& max_hits=10&format=XML&exceptions=XML&login=xxx&password=xxx http://kortforsyningen.kms.dk/service?stednavn=næstved&soegemetode=0&servicename=geoS& max_hits=10&format=XML&exceptions=XML&login=xxx&password=xxx Parameterværdier er case-sensitive, med mindre andet er nævnt, mens parameternavnene er case-insensitive. Der vil derfor være forskel på SERVICENAME=geoS og SERVICENAME=geos. Omvendt er der ingen forskel på SERVICENAME=geoS og ServiceName=geoS. Parameterværdier, der ikke er case-sensitive , vil fremgå senere i dette dokument. Parameteren ServiceName er altid nødvendig, uanset hvilken geonøgle, der anvendes. For de enkelte geonøgler er der desuden yderlige nødvendige og valgfrie parametre. At der er valgfrie parameter skyldes, at de har en standardværdi. Det betyder, at angives parameteren ikke i URLen, så vil standardværdien benyttes for den pågældende parameter. Et eksempel er parameteren FORMAT, der har standardværdien ASCII. Http forespørgselstype og URL encoding Forespørgsler til Kortforsyningen kan gøres ved hjælp af både post og get metoderne. Ved get angives parametrene i adressen (URLen) som beskrevet ovenfor. Ved post sendes parametrene skjult i selve HTTP-forespørgslen. Post opbygges typisk ved hjælp af formular-felter () med typen action=post. Benytter man get-metoden anbefales det for visse af geonøglerne at URL encode dele af URL'en før sendes mod Kortforsyningen. Ved brug af geoVA er det påkrævet at URL encode værdien af parameteren multi. URL encoding betyder blot at visse tegn i URL'en erstattes med en kode startende med % efterfulgt af en hexadecimal tal. Disse tegn er typisk ikke-latinske tegn fx mellemrum og semikolon samt tegn med en regional tilknytning fx æ, ø og å. Nedenfor er vist to eksempler på en streng før og efter URL encoding. Før: Hello World! Efter: Hello%20World%21 Før: http://kortforsyningen.kms.dk/service?servicename=geoS&stednavn=hærup&... Efter: http://kortforsyningen.kms.dk/service?servicename=geoS&stednavn=h%E6rup&... Der findes metoder til URL encoding i de fleste script- og programmeringssprog. Nedenfor er vist nogle eksempler. JavaScript var myURLEncodedString = escape("Hello World!"); ASP/VBScript Dim myURLEncodedString myURLEncodedString = Server.URLEncode("Hello World!") Det anbefales at URL encode alle parametre, der kan indeholde specielle tegn som æ, ø, å, mellemrum og semikolon. Det er fx parametre som stednavn i geoS og vejnavn i geoV. Bruger man metoden post behøver man ikke gøre noget, da metoden selv automatisk URL encoder. Side 6 af 94
Kort & Matrikelstyrelsen Kortforsyningen Version 2.13, 2010-05-21 Fælles parametre for alle geonøgler Præfiks Præfixet af URLen (frem til og med ?) vil være ens uanset hvad der forespørges på. I nedenstående URL er præfixet markeret med gult: http://kortforsyningen.kms.dk/service?servicename=geoS&stednavn=næstved&soegemetode=0& max_hits=10&format=XML&exceptions=XML&login=xxx&password=xxx ServiceName ServiceName skal altid angives. Der er følgende gyldige værdier ServiceName Beskrivelse geoS Søgning på position for et givent stednavn i Danmark, Grønland og på Færøerne. Søgning kan i Danmark begrænses til en given kommune eller amt. geoS7 Søgning på position for et givent stednavn i Danmark, Grønland og på Færøerne. Søgning kan i Danmark begrænses til en given kommune eller region. geoSS Søgning på mindste omkransende rektangel for et stednavn i Danmark. Søgningen kan begrænses til en bestemt kategori af stednavne. geoP Søgning på postnummer for et givent postdistrikt. Det er muligt at søge på dele af postdistriktsnavnet, hvis ikke hele navnet kendes. geoK Søgning på kommunekode for et givent kommunenavn. Det er muligt at søge på dele af kommunenavn, hvis ikke hele kommunenavnet kendes. geoKN Søgning på kommunekode og regionskode for et givent kommunenavn. Det er muligt at søge på dele af kommunenavn, hvis ikke hele kommunenavnet kendes. geoK7 Søgning på kommune (før og efter 1/1 2007), amt og region for et givent punkt. geoV Søgning på vejkode for et givent vejnavn. Det er muligt at søge på dele af vejnavnet, hvis ikke hele vejnavnet kendes. Søgning kan begrænses til et givent postnummer eller en given kommune. geoV7 Søgning på vejkode, postnummer (det første i husnummerorden), postdistrikt, og evt. supplerende oplysninger for et givent vejnavn. Ny version af geoV med hensyn til administrative reform fra 1/1 2007. geoA Søgning på positionen for en given adresse defineret af en vejkode, et postnummer/kommunekode og evt. et husnummer. geoA7 Ny version af geoA med hensyn til administrative reform fra 1/1 2007. geoAS Søgning på mindste omkransende rektangel for et stednavn i Danmark. Søgningen kan begrænses til autoriserede stednavne. geoNA Søgning efter nærmeste adresser til en given position. geoNA7 Søgning efter nærmeste adresser og supplerende oplysning til en given position. geoAM Søgning på positionerne for flere givne adresser defineret af en vejkode, et postnummer/kommunekode og husnummer. geoVA Søgning på positionerne for flere givne adresser defineret af et vejnavn, et postnummer/kommunekode og husnummer. geoVA7 Søgning på positionerne for flere givne adresser defineret af et vejnavn, et postnummer/kommunekode, et bynavn og husnummer. Ny version af geoV med hensyn til administrative reform fra 1/1 2007. geoM Søgning på position for en given matrikel defineret af et matrikelnummer og en ejerlavskode eller af et ejendomsnummer. geoBM Søgning efter alle matrikler indenfor et givent rektangulært område. geoEM Søgning på alle matrikler i et givent ejerlav. geoE Søgning på ejerlavskode udfra et ejerlavsnavn. Det er muligt at søge på dele af ejerlavsnavnet. geoKE Søgning på ejerlav i en given kommune. geoO Matrikelnummer og ejerlav for en given position. geoT Transformation af koordinater fra en projektion/datum til en anden. Side 7 af 94
Page 1 and 2: M I L J Ø M I N I S T E R I E T KO
Page 3 and 4: Kort & Matrikelstyrelsen Kortforsyn
Page 5: Kort & Matrikelstyrelsen Kortforsyn
Page 57 and 58:
Kort & Matrikelstyrelsen Kortforsyn
Page 59 and 60:
Page 61 and 62:
Page 63 and 64:
Page 65 and 66:
Page 67 and 68:
Page 69 and 70:
Page 71 and 72:
Page 73 and 74:
Page 75 and 76:
Page 77 and 78:
Page 79 and 80:
Page 81 and 82:
Page 83 and 84:
Page 85 and 86:
Page 87 and 88:
Page 89 and 90:
Page 91 and 92:
Page 93 and 94:
show all

Dokumentation af geonÃ¸gler Classic - Kortforsyningen

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?