Avoimet rajapinnat ja ladattavat LIPAS-aineistot

Lipas-tietokannan tietosisältöä voi hyödyntää avoimen datan periaatteita noudattaen yksityisessä, julkisessa, kaupallisessa, ei-kaupallisessa tai muussa tarkoituksessa. Lipas-tietokannan käyttöehdot noudattavat avoimen datan CC Nimeä 4.0 Kansainvälinen -lisenssiä. Aineiston käyttäjän katsotaan hyväksyvän käyttöehdot, kun hän lataa tai muuten ottaa aineiston tai sen osan käyttöönsä.

CC Nimeä 4.0-lisenssin mukaan aineiston käyttäjän tulee viitata käytettyyn tietolähteeseen. Sopiva viittaustapa on esim. "Jyväskylän yliopisto, Lipas Liikuntapaikat.fi" tai "Jyväskylän yliopisto Lipas-tietokanta". Lisäksi on hyvä mainita otosajankohta. Lipas-tietokannan tietosisältö on jatkuvasti päivittyvää, joten eri aikoina otetut otokset voivat erota toisistaan.

Lipas-tietokannan tietosisältöä voi selata ja ladata www.lipas.fi –verkkopalvelussa. Palvelussa voi esimerkiksi katsella haluttujen liikuntapaikkojen tietoja kartalla, koostaa haluamansa tiedot ja tietosisällöt ladattavaan raporttiin (excel-, CSV- tai GeoJSON-formaatit) sekä käyttää interaktiivisia tilastokuvaajia Tilastot-osiossa. Reittitietoja voi ladata myös .gpx-muodossa. 

Valmiita aineistopaketteja on ladattavissa Jyväskylän yliopiston JYX-julkaisuarkistossa. Palvelussa on eri vuosilta ns. ”päivän otoksia” shapefile-muodossa. Omia excel, CSV- tai GeoJSON-aineistoja on mahdollista ladata suoraan lipas.fi-palvelusta.

Oman aineistopaketin voi ladata myös suoraan Geoserveriltä verkkoelainta käyttäen. Layer preview - näkymästä voi katsoa tarjolla olevat karttatasot (huom. oletuskysely 50 kohdetta). 

Alla ovat kyselyt, joilla voi hakea shapefile-tyyppiset otokset nettiselainta hyödyntäen. Kyselyihin on merkitty oletuksena 50 kpl otos, mutta voit itse vaihtaa otoskoon suuremmaksi.  Attribuuttitietoina mukana kyselyissä tulevat liikuntapaikkojen perustiedot. 

http://lipas.cc.jyu.fi:80/geoserver/lipas/ows?service=WFS&version=1.0.0&request=GetFeature&typeName=lipas%3Alipas_kaikki_alueet&maxFeatures=50&outputFormat=SHAPE-ZIP (alueet)

http://lipas.cc.jyu.fi/geoserver/lipas/ows?service=WFS&version=1.0.0&request=GetFeature&typeName=lipas%3Alipas_kaikki_reitit&maxFeatures=50&outputFormat=SHAPE-ZIP (reitit)

http://lipas.cc.jyu.fi/geoserver/lipas/ows?service=WFS&version=1.0.0&request=GetFeature&typeName=lipas%3Alipas_kaikki_pisteet&maxFeatures=50&outputFormat=SHAPE-ZIP (pisteet)

Voit pyytää apua otoksen laadintaan sähköpostitse lipasinfo@jyu.fi

Web Map Service (WMS)

LIPAS-järjestelmässä on avoin WMS-rajapinta liikuntapaikkatiedon katseluun ja näyttämiseen paikkatieto-ohjelmissa ja karttapalveluissa. Rajapinnalta on käytettävissä useita erilaisia karttatasoja erilaisilla tietosisällöillä. "Isot" tasot eli pisteet, reitit ja alueet sisältävät kaikki geometriatyypin kohteet sijaintitietoineen sekä ja perustason attribuuttitiedot (=liikuntapaikan perustiedot). Perustiedot kerätään yhdenmukaisesti kaikista liikuntapaikoista.

Liikuntapaikkatyyppikohtaiset WMS-tasot ovat karttatasoja, joissa esitetään yhden liikuntapaikkatyypin kaikki kohteet ja kaikki attribuuttitiedot joita tyypistä kerätään. WMS-tasoja voi käyttää myös liikuntapaikkaryhmittäin.

Lisätietoja WMS eli karttakuvapalvelusta:
Rajapinnan osoite: http://lipas.cc.jyu.fi/geoserver/lipas/wms
Rajapinnan https-osoite: https://lipas.fi/geoserver/lipas/wms

Web feature service (WFS)

Web Feature Service on rajapinta, jolla haetaan paikkatietokohteita eli vektorimuotoista paikkatietoaineistoa. WFS-rajapinnan kautta aineistoa voi tallentaa omaan käyttöön.

WFS:ssä lähetetään pyyntöjä XML-muodossa, jolloin palvelin palauttaa pyydetyn tyyppiset kohteet pyydetyltä alueelta XML-muodossa. Myös WFS-pyynnöt välitetään HTTP-protokollalla. WFS:n XML-kuvauskieli on GML:n mukaista ja se sisältää paikkatiedon sekä spatiaalisten että ei-spatiaalisten ominaisuuksien mallinnukseen, tiedonvälitykseen ja tallennukseen.

WFS-rajapintaan voi tutustua tarkemmin osoitteessa: http://www.opengeospatial.org/standards/wfs

WFS-rajapinnan osoite: http://lipas.cc.jyu.fi/geoserver/lipas/ows
WFS-rajapinnan https-osoite: https://lipas.fi/geoserver/lipas/ows

Aineistot tarjotaan EPSG 3067-koordinaatistossa. Useimmat paikkatieto-ohjelmat antavat kuitenkin mahdollisuuden ladata aineistoa, missä tahansa koordinaatistossa, jota ohjelma tukee. Aineisto tarjotaan vastaavissa karttatasoissa kuin WMS-palvelussakin: pisteet, reitit ja alueet - karttatasot kattavat koko maan kaikki geometriatyyppiin kuuluvat kohteet. Tyyppikohtaiset karttatasot sisältävät yhden tyypin kaikki kohteet kaikkine ominaisuustietoineen. 

Suosittelemme että testikyselyissä rajataan aineisto enintään 50 kohteeseen, jotta rajallinen palvelinkapasiteettimme ei jumiutuisi virheellisiin kyselyihin.  WFS- WMS-rajapintoihin voi kytkeytyä myös MapInfo, ArcGis ja QGis-ohelmilla, joiden avulla voi tehdä vapaamuotoisen aineistopoiminnan.

Lipas-aineistoa voi ladata myös suoraan Geoserviltä. Tarjolla on lukuisa määrä eri aineistomuotoja. Oletuksena kysely palauttaa 50 kpl kohteita.

Geoserverin verkko-osoite: http://lipas.cc.jyu.fi/geoserver/web/
Geoserverin https-versio: https://lipas.fi/geoserver/lipas/ows

REST-api

Lipas-tietokannan hyödyntämistä varten on avattu REST-rajapinta.
REST-rajapinnan osoite: http://lipas.cc.jyu.fi/api/ 
REST-rajapinnan https-osoite: https://lipas.fi/rest/

Tutustu REST-apin dokumentaatioon GitHubissa

Ongelmista voi raportoida suoraan GitHubiin:
https://github.com/lipas-liikuntapaikat/lipas-api/issues

Tutustu rajapintojen kautta välitettäviin karttatasoihin ja liikuntapaikkatyyppeihin taulukkomuodossa

Tutustu LIPAS-järjestelmän liikuntapaikkojen ominaisuustietokenttiin