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 S7 (geoS7)<br />
Denne geonøgle returnerer positionen og det administrative tilhørsforhold for et givent stednavn.<br />
Hensigten er, at denne geonøgle kan bruges efter strukturreformen, og den returnerer derfor det<br />
fremtidige (fra 1/1 2007) tilhørsforhold.<br />
Parameter Gyldige værdier Standardværdi Beskrivelse<br />
ServiceName geoS - Angiver hvilken geonøgle der ønskes anvendt.<br />
Obligatorisk<br />
Format<br />
Stednavn<br />
Soegemetode 0<br />
1<br />
2<br />
3<br />
Omraade<br />
regionskode<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 regionskode<br />
(positivt heltal bestående <strong>af</strong><br />
fire tal)<br />
Kommunekode Enhver gyldig<br />
kommunekode (positivt<br />
heltal bestående <strong>af</strong> tre tal)<br />
HTML<br />
Det ønskede returformat. Se <strong>af</strong>snittet Output for<br />
beskrivelse. Valgfri<br />
- Det søgte stednavn, eller del her<strong>af</strong>, <strong>af</strong>hængigt <strong>af</strong><br />
søgemetode (se nednfor). Obligatorisk. Værdien er<br />
case-insensitive.<br />
1 Angiver søgemetode:<br />
0: Der søges efter det eksakte stednavn<br />
1: Der søges efter stednavne som begynder med<br />
værdien <strong>af</strong> parameteren stednavn<br />
2: Der søges efter stednavne som indeholder værdien <strong>af</strong><br />
parameteren stednavn.<br />
3: Der søges efter stednavne som slutter med værdien<br />
<strong>af</strong> parameteren stednavn.<br />
dk<br />
Valgfri.<br />
Angiver om der skal søges blandt stednavne i Danmark,<br />
på Færøerne eller i Grønland. Valgfri.<br />
-1 regionskode angiver hvilket region, dit stednavn skal<br />
være beliggende i. Angives intet eller er værdien 1<br />
søges i hele landet, med mindre der er angivet en<br />
kommunekode. Parameteren har ingen effekt, hvis<br />
omraade=faro eller omraade=gr. Valgfri<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 />
Valgfri<br />
Exceptions ASCII<br />
HTML<br />
XML<br />
application/vnd.ogc.se_xml<br />
ASCII 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 regionskoden 1084 (svarende<br />
til Region Hovedstaden) 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=geoS7&soegemetode=0&stednavn=virum&r<br />
egionskode=1084&kommunekode=-1&format=XML&max_hits=10&login=xxx&password=xxx<br />
Ønskede man at søge i hele Danmark skal både regions- 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 />
http://kortforsyningen.kms.dk/service?ServiceName=geoS7&soegemetode=1&stednavn=ana®<br />
ionskode=-1&kommunekode=-<br />
1&format=ASCII&max_hits=10&omraade=gr&login=xxx&password=xxx<br />
Da en række <strong>af</strong> parametrene i ovenstående URL er valgfrie, kunne en tilsvarende søgning også<br />
skrives på følgende måde og få returneret samme resultat:<br />
Side 11 <strong>af</strong> 94