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 />
Geonøgle S (geoS)<br />
Denne geonøgle returnerer positionen for en eller flere stednavne. Bemærk at:<br />
· Et navneobjekt som har både stednavn og stamoplysning tilknyttet forekommer med både<br />
sted- og stamnavnet.<br />
· Visse navneobjekter (f.eks. skove) dækker flere kommuner, hvilket betyder at det samme<br />
navn (med samme koordinater) kan forekomme flere gange, men med forskellige<br />
kommunale tilhørsforhold.<br />
· Denne geonøgle er fra 1/1 2007 erstattet <strong>af</strong> geoS7, der på inputsiden kun adskiller sig fra<br />
geoS ved at parameteren amtskode er omdøbt til regionskode<br />
Parameter Gyldige værdier Standardværdi Beskrivelse<br />
ServiceName geoS - Angiver hvilken geonøgle der ønskes anvendt. S betyder<br />
at der søges efter et stednavn. Obligatorisk<br />
Format<br />
Stednavn<br />
Soegemetode 0<br />
1<br />
2<br />
3<br />
Omraade<br />
Amtskode<br />
ASCII<br />
HTML<br />
XML<br />
Enhver kombination <strong>af</strong><br />
karakterer. En tom tekst<br />
() er ikke tilladt.<br />
dk<br />
faro<br />
gr<br />
Enhver gyldig amtskode<br />
(positivt heltal bestående <strong>af</strong><br />
fire tal)<br />
HTML<br />
Det ønskede returformat. Se <strong>af</strong>snittet Output for<br />
beskrivelse. Valgfri<br />
- Det søgte stednavn (eller dele <strong>af</strong> det <strong>af</strong>hængig <strong>af</strong><br />
søgemetode). Obligatorisk. Værdien er caseinsensitive<br />
1 Angiver søgemetode<br />
0 = det eksakte stednavn behøves<br />
1 = kun starten <strong>af</strong> stednavn behøves<br />
2 = kun starten, slutningen eller midten <strong>af</strong> stednavn<br />
behøves<br />
3 = kun slutningen <strong>af</strong> stednavn behøves<br />
dk<br />
Valgfri<br />
Angiver hvilket <strong>af</strong> områderne Danmark, Færøerne og<br />
Grønland, stednavnet er lokaliseret. Angives intet eller er<br />
værdien ikke gyldig, søges i Danmark. Valgfri<br />
-1 Amtskode angiver hvilket amt, dit stednavn skal være<br />
beliggende i. Angives intet eller er værdien 1 søges i<br />
hele landet, med mindre der er angivet en<br />
kommunekode. Parameteren har ingen effekt, hvis<br />
omraade=faro eller omraade=gr. Valgfri<br />
Kommunekode Enhver gyldig<br />
kommunekode (positivt<br />
heltal bestående <strong>af</strong> tre tal)<br />
-1 Kommunekode angiver hvilken kommune, dit stednavn<br />
skal være beliggende i. Angives intet eller er værdien 1<br />
søges i hele landet med mindre en amtskode er angivet.<br />
Parameteren har ingen effekt, hvis omraade=faro eller<br />
omraade=gr. Valgfri<br />
Max_hits Heltal større end 0 20 Angiver det maksimalt antal returnerede søgeresultater.<br />
Exceptions<br />
ASCII<br />
HTML<br />
XML<br />
application/vnd.ogc.se_xml<br />
ASCII<br />
Valgfri<br />
Fejlmeddelelser returneres i det format Exceptions<br />
parameter angiver. Valgfri<br />
Eksempel på URL<br />
Nedenstående URL vil søge efter stednavnet Virum beliggende i amtskoden 1020 (svarende til<br />
Frederiksborg Amt) og returnere maksimalt 10 søgeresultater i XML-format. Bemærk at kun<br />
resultater, der matcher stednavnet præcist, returneres da søgemetode 0 er valgt.<br />
http://kortforsyningen.kms.dk/service?ServiceName=geoS&soegemetode=0&stednavn=virum&a<br />
mtskode=1020&kommunekode=-1&format=XML&max_hits=10&login=xxx&password=xxx<br />
Ønskede man at søge i hele Danmark skal både amts- og kommunekode sættes lig 1.<br />
Nedenstående URL vil søge efter stednavne i Grønland som starter med ana og returnere<br />
maksimalt 10 søgeresultater i ASCII-format.<br />
Side 9 <strong>af</strong> 94