Ohjeet kielikartaston WFS-rajapinnan käyttöön

Kotus kielikartastot -aineiston kohteita voi tarkastella ja ladata WFS-rajapinnan avulla. WFS-rajapinta tarjoaa mahdollisuuden tehdä aineistoon liittyviä HTTP GET- ja POST-kutsuja esimerkiksi internetselaimella tai paikkatieto-ohjelmistolla (ArcMap, MapInfo, QGIS jne.). OGC:n rajapintojen yleiset kuvaukset ja käyttöohjeet löytyvät CSC:n geotietieden ohjesivuilta (ks Rajapintapalvelut).
 
 

Kielikartaston WFS-rajapinnan tiedot

 
WFS URL http://avaa.tdata.fi/geoserver/kotus/wfs?
Koordinaattijärjestelmä Oletuksena: ETRS-TM35FIN (EPSG: 3067), tarvittaessa kaikki muut EPSG-koodin avulla

Karttatasot

  • Ilmiöt:
    • kotus:paikkatieto_view
  • Taustakartan rajat:
    • kotus:pitajat
    • kotus:rajat-sms-alueosat
    • kotus:rajat-lansi-ita
    • kotus:rajat-sms-alueet
Tiedostomuodot
  • outputformat=
    • SHAPE-ZIP
    • csv
    • GML2
    • GML3
    • application/json (geojson)
    • text/javascript
Lisätietoja
Ilmiön tiedot fid, ilmio_id, aineisto_id, aineisto_nimi, alaryhma_id, alaryhma_nimi, ylaryhma_id, ilmio, tyyppi, kuvaus, paikka_nimi, paikantyyppi, mml_paikkaid
aineisto_id
  • 1 = Itämerensuomalainen kielikartasto IMSK
  • 2 = Kettusen murrekartasto
  • 3 = Suomen murteiden sanakirjan levikkikartat
  • 4 = Svenska Ortnamn i Finland
  • 5 = Paikannimikartasto
Rajoitukset GeoServerin rajapinnalta voi hakea max 100 000 kohdetta kerralla, joten koko aineiston lataukset yhdellä haulla eivät ole mahdollisia. Koko aineiston lataamiseksi käytä "Aineistot" välilehdellä olevia latauspaketteja.

 

Esimerkkejä rajapinnan käytöstä

 

GetCapabilities kertoo palvelun ominaisuudet

http://avaa.tdata.fi/geoserver/kotus/wfs?request=GetCapabilities
GetCapabilities palauttaa XML-tiedoston, joka sisältää muun muassa aineistolle saatavissa olevat tiedostomuodot, aineiston käyttämän koordinaattijärjestelmän, aineiston karttatasot ja kullekin karttatasolle mahdolliset WFS-kutsut.
 
 

Ilmiön haku

Esimerkissä:

  • haetaan kaikki ilmiön (ID=1806) paikat (filter=...)
  • tiedosto ladataan Shape formaadissa (outputformat=SHAPE-ZIP)
  • tiedoston nimi on "kotus.zip"
http://avaa.tdata.fi/geoserver/kotus/ows?service=WFS&version=1.0.0&request=GetFeature&typeName=kotus:paikkatieto_view&outputformat=SHAPE-ZIP&Filter=<Filter><PropertyIsEqualTo><PropertyName>ilmio_id</PropertyName><Literal>1806</Literal></PropertyIsEqualTo></Filter>&format_options=filename:kotus.zip
 
 

Ryhmän haku

Esimerkissä:

  • haetaan kaikki ryhmän (ID=75063) paikat (filter=...). Hierarkisen rakennen takia ryhmän ID-ta haetaan sekä yläryhmän että alaryhmän kentästä.
  • tiedosto ladataan GML3 formaadissa (outputformat=GML3)
http://avaa.tdata.fi/geoserver/kotus/ows?service=WFS&version=1.0.0&request=GetFeature&typeName=kotus:paikkatieto_view&Filter=<Filter><Or><PropertyIsEqualTo><PropertyName>alaryhma_id</PropertyName><Literal>75063</Literal></PropertyIsEqualTo><PropertyIsEqualTo><PropertyName>ylaryhma_id</PropertyName><Literal>75063</Literal></PropertyIsEqualTo></Or></Filter>&outputformat=GML3