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ä. |
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ä.