Suomen lajitietokeskuksella on kaksi avoimesti saatavilla olevaa rajapintaa:
https://ogcapi.laji.fi (josta myös versio https://ogcapi.laji.fi/virva viranomaisille)
api.laji.fi (REST + ”Warehouse”-endpoint)
- Tämä rajapinta sisältää kaiken Lajitietokeskuksen avoimen datan, kuten taksonomiat, metatiedot, lajitiedot, linkitykset ym.
- Mahdollisuus hakea dataa ohjelmallisesti (Esim. FME, Python, JavaScript). Rajapinta palauttaa tiedot JSON, JSON-LD tai GeoJSON -formaateissa.
- Jos haet sensitiivistä / rajoitettua dataa, tarvitset permissionTokenin ja access_tokenin (joilla varmistutaan käyttöoikeuksista). Tämän saa viranomaisportaalista tai aineistopyynnöllä. AccessTokenin avulla voit hakea vain niitä karkeistettuja havaintoja, jotka olet tokenia luodessa määrittänyt.
- Tämä on siis eri token, kuin OGC API Featuresissa.
- Warehouse-endpoint sisältää kaikki yli 50 miljoonaa lajihavaintoa ”raakadatana”. Mukana kaikki tieto, mitä kyseisiin lajihavaintoihin sisältyy ns. raakadatana, eli englanninkielisenä / tunnisteita käyttäen.
- Dokumentaatio: https://info.laji.fi/en/frontpage/api/
ogcapi.laji.fi (OGC API Features / paikkatietorajapinta)
- Perustuu standardiin OGC API Features (WFS:n seuraaja), mikä tekee siitä standardoidun tavan hakea paikkatietoja. Helposti yhdistettävissä yleisimpiin paikkatieto-ohjelmistoishin (QGIS, ArcGIS Pro) ja myös ohjelmallisesti (esim. FME, Python, R).
- Sisältää n. 6 miljoonaa lajihavaintoa:
- kaikki vieraslajien lajihavainnot
- eliömaakunnittain jaotellut ja virva-rajauksin valitut lajihavainnot
- ”All Data as Center Points” -erikoisaineiston, joka muuntaa lennossa kaikki api.laji.fi:n lajihavainnot OGC API Features -standardin mukaiseen helposti käytettävään muotoon.
- Rajapinta tarjoaa datan suomenkielisenä ja siistittynä HTML, GeoJSON- tai CSV-muodossa.
- Rajapinnassa on erikseen avoin puoli (https://ogcapi.laji.fi) ja vain viranomaisille tarkoitettu puoli (https://ogcapi.laji.fi/virva), jonka käyttöön tarvitsen viranomaisportaalista haetun API-avaimen. Tämä API-avain on siis eri, kuin api.laji.fi-rajapinnassa.
- Mahdollisuus tarkastella dataa suoraan selaimessa (esim. Pohjois-Savon aineisto).
- Dokumentaatio: https://info.laji.fi/etusivu/paikkatieto/rajapintayhteydet/
Kumpaa minun tulisi käyttää?
| Käyttötarve / tilanne | Suositeltu rajapinta |
| Haluan saada kaikki lajihavainnot ja niiden attribuuttitietoni käyttööni ohjelmallisesti, eikä minua haittaa, ettei data ole valmiiksi siistittyä. | api.laji.fi (Warehouse-endpoint) |
| Haluan lajihavainnot paikkatietona QGIS:iin helposti käytettävästi. | ogcapi.laji.fi (OGC API Features) |
| Tarvitsen sensitiivistä dataa esim. uhanalaisten lajien tarkoista sijainneista. Minulla on mahdollisuus saada API-avain / personToken. | Molemmat. Tarvitset tosin API-avaimen / personTokenin. OGC API Featuresin tapauksessa voit joutua käyttämään ”All Data as Center Points” -aineistoa, mikäli haluamasi lajit eivät sisälly VIRVA-rajauksiin. |
| Haluan vain nopeasti vilkaista, miltä lajihavainnot näyttää. | ogcapi.laji.fi (OGC API Features) |
| Haluan käyttööni muutakin tietoa, kuin lajihavaintoja. Esim. havaintojen yhteyteen liitetyt kuvat, tarkemmat taksonomiatiedot, selitteet tai metatiedot. | api.laji.fi |
| Haluan lajihavaintoni suomenkielellä ja helposti käytettävänä. | ogcapi.laji.fi (OGC API Features) |
| Tarvitsen tietoa myös lajihavainnoista, jotka eivät sisälly VIRVA-rajauksiin. | api.laji.fi (Warehouse-endpoint) Tai OGC API Featuresin ”All Data as Center Points” -aineisto. |
| Haluan saada tunturihaukan tai tunturipöllön tarkat sijainnit selville. | Ei kumpikaan. Lajit ovat niin sensitiivisiä, että näitä saa vain erikseen kysymällä. |
Vertailutaulukko
| OGC API Features | api.laji.fi | |
| Tarkoitus | Lajihavaintojen hyödyntämiseen paikkatietona koneellisesti uusimpien standardien mukaisesti | Lajihavaintojen + kaiken muut tiedon hyödyntämiseen koneellisesti |
| Mitä dataa? | Reilu 6 milj. lajihavaintoa sellaisenaan (virva-rajaukset + vieraslajit), sekä kaikkien lajihavaintojen keskipisteet. Karkeistettuna julkisella puolella, karkeistamattomana viranomaispuolella. | Lajihavaintojen lisäksi kaikki muukin lajitietokeskuksen tieto (esim. kuvat, taksonomiat, tunnisteet ym. ) |
| Sisältö | – Samankaltaiset ja päällekkäiset havainnon yhdistetty – GeometryCollectionit muutettu MultiGeometrioiksi – Suomenkielinen ja helppo tietosisältö (arvoissa ei turhia linkkejä, tunnisteita tai lyhenteitä) – Lisätty tietoa, joka ei suoraan saatavilla warehouse-endpointista: esim. taksonomiatiedot, ELY-keskus -alue, tieto yhdistetyistä havainnoista ja esiintymän tila | – Ns. raakadata – Englanninkielinen / tekninen sanasto. (Arvot usein tunnisteita/lyhenteitä) |
| Autentikaatio | Viranomaisportaalista saa API-avaimen, jolla käytettävissä kaikki sensitiivinen data karkeistamattomana. Avoimella puolella ei tarvitse autentikaatiota. | Aineistopyyntöjärjestelmän kautta voi saada API-avaimen tietyille aineistorajauksille, jolla tieto karkeistamattomana. Muuten avoin.. |
| Suorituskyky | Hyvä maantieteellisissä rajauksissa. | Heikohko maantieteellisissä rajauksissa. Muissa hyvä. |
| Ristiinkäyttö | Tunnisteet tulee sellaisenaan api.laji.fi:stä. Alkuperäinen tunniste on aina saatavilla. | |
| Filtteröinti | Attribuutin tai sijainnin mukaan (bbox, intersects) | Attribuuttien tai bboxin mukaan. |
| Paging | Standardoitu (limit, offset / links) | Käytössä (page, pageSize) |
| Käyttö | Paikkatieto-ohjelmistot, web-kartat | Vaatii usein esiprosessointia |
| Dokumentointi | info.laji.fi, lisäksi rajapinnan /collections /conformance /openapi | info.laji.fi ja api.laji.fi -sivustolla. Myös schema.laji.fi. |
Onko muuta tapaa käyttää rajapintoja lajihavaintojen hakemiseen?
On! Voit esimerkiksi käyttää R-pakettia tai QGIS-pluginia, jotka on rakennettu api.laji.fi-rajapinnan päälle. Näiden käyttö voi olla helpompaa ja mukavampaa, mikäli käytät R:ää tai QGIS:iä.