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 SS (geoSS)<br />
Denne geonøgle returnerer stednavne og disses geogr<strong>af</strong>iske udbredelse. Dette sker i form <strong>af</strong><br />
koordinater for det mindste rektangel (bounding box) som omkranser stednavneobjektet<br />
svarende til det givne stednavn. Bemærk at:<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 />
Parameter Gyldige værdier Standardværdi Beskrivelse<br />
ServiceName geoSS - Angiver hvilken geonøgle der ønskes anvendt.<br />
Obligatorisk<br />
Format<br />
ASCII<br />
HTML<br />
XML<br />
HTML<br />
Det ønskede returformat. Se <strong>af</strong>snittet Output for<br />
beskrivelse. Valgfri<br />
Stednavn Enhver kombination <strong>af</strong><br />
tegn. En tom tekst () er<br />
ikke tilladt.<br />
- Det søgte stednavn (eller dele <strong>af</strong> det <strong>af</strong>hængig <strong>af</strong><br />
søgemetode). Obligatorisk. Store og små bogstaver<br />
behandles ens.<br />
Soegemetode En- eller tocifrede<br />
kombinationer <strong>af</strong><br />
0<br />
1<br />
2<br />
3<br />
f.eks. 03<br />
0 (begge cifre) De to cifre angiver søgemetode for henholdsvis<br />
stednavn og kategori. Hvert ciffer træder kun i kr<strong>af</strong>t hvis<br />
der angives 3 eller flere tegn i stednavnet hhv.<br />
kategorien. Cifrene har flg. betydning:<br />
0 = det/den eksakte stednavn hhv. kategori behøves<br />
1 = kun starten <strong>af</strong> stednavn hhv. kategori behøves<br />
2 = kun starten, slutningen eller midten <strong>af</strong> stednavn hhv.<br />
kategori behøves<br />
3 = kun slutningen <strong>af</strong> stednavn hhv. kategori behøves<br />
Valgfri. Angives kun 1 ciffer benyttes det som<br />
søgemetode for stednavnet, og kategori anvender<br />
standardværdien 0.<br />
Kategori Enhver kombination <strong>af</strong><br />
tegn.<br />
- Kategori begrænser søgningen. Angives 3 eller flere<br />
tegn søges i alle kategorier som indeholder det angivne<br />
kategorinavn. For eksempel kan kategorien skole give<br />
resultater fra kategorierne Skole, Fagskole<br />
(erhvervsfaglig), Efterskole/Ungdomsskole, etc. Som<br />
for stednavn skelnes der ikke mellem store og små<br />
bogstaver. 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 Exception<br />
parameter angiver. Valgfri<br />
Eksempel på URL<br />
Nedenstående URL bruges til at søge efter de stednavneobjekter hvis navn begynder med "Skel",<br />
og hvis <strong>af</strong> kategori slutter med "Gård". For hvert stednavneobjekt returneres 4 koordinater som<br />
definerer det mindste område som omslutter objektet. Resultatet bedes angivet som XML, og<br />
eventuelle fejl returneres i OGC XML-format.<br />
http://kortforsyningen.kms.dk/service?servicename=geoSS&stednavn=skel&kategori=gård&soege<br />
metode=13&format=XML&exceptions=application/vnd.ogc.se_xml&login=xxx&password=xxx<br />
For at søge efter bounding boxes for alle stednavne som begynder med "Hel", uanset kategori,<br />
kan man bruge<br />
http://kortforsyningen.kms.dk/service?servicename=geoSS&stednavn=hel&soegemetode=1&max<br />
_hits=200&exceptions=application/vnd.ogc.se_xml&login=xxx&password=xxx<br />
(for at være sikker på at få alle forekomster sættes max_hits=200.)<br />
Side 13 <strong>af</strong> 94