25.03.2014 Views

Dokumentation af geonøgler Classic - Kortforsyningen

Dokumentation af geonøgler Classic - Kortforsyningen

Dokumentation af geonøgler Classic - Kortforsyningen

SHOW MORE
SHOW LESS

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

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!