# Rajapinnan hyödyntäminen QGIS:issä

**URL:** <https://foorumi.laji.fi/t/rajapinnan-hyodyntaminen-qgis-issa/12696>\
**Category:** API.laji.fi\
**Created:** [Maaliskuu 16, 2021, 9.37am UTC](https://foorumi.laji.fi/t/rajapinnan-hyodyntaminen-qgis-issa/12696 "2021-03-16T09:37:19Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![Mikko\_Petajaniemi](https://avatars.discourse-cdn.com/v4/letter/m/9e8a1a/32.png) [@Mikko\_Petajaniemi](https://foorumi.laji.fi/u/Mikko_Petajaniemi)\
**Post date:** [Maaliskuu 16, 2021, 9.37am UTC](https://foorumi.laji.fi/t/rajapinnan-hyodyntaminen-qgis-issa/12696/1 "2021-03-16T09:37:19Z")

</div>

Hei, onko [laji.fi](http://laji.fi) rajapintaa mahdollista hyödyntää qgis sovelluksessa? Tavoitteenani olisi demota pölyttäjäkasvien esiintymistä alueella millä tiedolla voitaisiin arvioida sijainnin soveltuvuutta mehiläistarhaukseen. Esimerkki vastaavasta palvelusta hollannissa: [http://geolab.has.nl/food4bees/indexkaart/](http://geolab.has.nl/food4bees/indexkaart/)

---

<div class="post-metadata">

**Author:** ![EskoP](https://sea1.discourse-cdn.com/flex019/user_avatar/foorumi.laji.fi/eskop/32/60661_2.png) [@EskoP](https://foorumi.laji.fi/u/EskoP)\
**Post date:** [Maaliskuu 30, 2021, 1.52pm UTC](https://foorumi.laji.fi/t/rajapinnan-hyodyntaminen-qgis-issa/12696/2 "2021-03-30T13:52:12Z")

</div>

Kiitos kysymyksestä ja pahoittelut, että vastaus on viivästynyt!

[api.laji.fi](http://api.laji.fi/) rajapinnasta on mahdollista saada tietoa ulos GeoJSON -muodossa.

QGIS pystyy ottamaan tämän tiedon vastaan. Seuraavassa on ohjeet, kuinka rajapinnan vastaus linkitetään QGIS-sovelluksessa:

1. Valitaan QGIS-projektin ylävalikosta Layer - Add Layer - Add vector Layer
2. Valitaan aukeavasta ikkunasta Protocol: HTTPS, Cloud, etc. ja vaihdetaan Encoding: System
3. Valitaan Type -valikosta GeoJSON ja lisätään API:sta saatu URI-linkki URI-osoitepalkin kohdalle. Lopuksi painetaan ”Add”.
4. Kun aineisto on latautunut, voit tehdä siitä paikallisen kopion tietokoneellesi klikkaamalla tasoa hiiren oikealla ja valitsemalla Export → Save Features as… ja samalla muuttaa tiedostomuodon esim. shapefile tai geopackage -muotoon.

![image](https://us1.discourse-cdn.com/flex019/uploads/laji/original/3X/2/2/22507c7cf26a3733b15f7626b6a9f8dd291c33db.png)

–

![image (1)](https://us1.discourse-cdn.com/flex019/uploads/laji/original/3X/9/5/957959c0adf347960f89ac1a294786b040476e3e.png)

–

 ![image (2)](https://us1.discourse-cdn.com/flex019/uploads/laji/original/3X/b/8/b8f01272eee7ef0834f11b2b8a9bdeea5e154f86.png)

Mikäli haet rajapinnasta muita kuin WGS84 koordinaatistoa, pitää vaihtaa QGIS-projektin käyttämä koordinaattijärjestelmä. YKJ-järjestelmää vastaa `epgs 2393`

 ![image (3)](https://us1.discourse-cdn.com/flex019/uploads/laji/original/3X/a/c/acd2aa30eded662fe8d179545b11e867ee5fec4d.png)

–

 ![image (4)](https://us1.discourse-cdn.com/flex019/uploads/laji/original/3X/e/e/eeb75b811d34be630458f51862c4dcc266722f76.png)

**Hakulinkin muodostaminen**

- Alla on esimerkki erääseen rajapinnan kyselyyn.
- Jos kuvailet meille tarkemmin tietotarpeesi, voimme auttaa sinulle sopivan kyselyn muodostamisessa.
- Kysely on lajitietokeskuksen testipalveluun. Testipalvelulla on hyvä ensin harjoitella, etteivät kyselyt rasita tuotantopalvelinta (jossa on enemmän dataa)
- Kysely on itse asiassa epäsuositeltava. Suositeltavampi linkki olisi `dev.laji.fi` sijasta osoitteeseen `apitest.laji.fi`
- Tehdessä kysely `apitest.laji.fi` -osoitteeseen, pyyntöön pitää lisäksi lisätä `&access_token=xxxxxx` parametri. Tässä ohjeita access tokenin saamiseksi: [API.LAJI.FI | Suomen Lajitietokeskus](https://laji.fi/about/3120)
- Tuotantopavelun osoite on `api.laji.fi`
- Rajapinnan kaikista ominaisuuksista on dokumentaatio täällä: [API.LAJI.FI](https://apitest.laji.fi/explorer/#!/Warehouse/get_warehouse_query_unit_aggregate)

`https://dev.laji.fi/api/warehouse/query/unit/aggregate?geoJSON=true&aggregateBy=gathering.conversions.ykj1kmCenter.lat,gathering.conversions.ykj1kmCenter.lon,unit.taxonVerbatim,unit.unitId&pageSize=100&page=1&target=plantae&time=2010/2020`

Kysely palauttaa Plantae (kasvit) havainnot vuosilta 2010-2020, 1KM kokoisin YKJ ruuduittain (ruutu selvitetty mahdollisesti laajemman alueen keskipisteeseen). Ryhmittelyyn on otettu mukaan lajihavainnon alkuperäinen ilmoitettu määritys (taxonVerbatim) ja havainnon tunniste - näiden lisäksi tai sijasta olisi mahdollista valita mitä tahansa käytettävissä olevista kentistä, nämä on valittu esimerkkinä.

Tärkein huomio linkissä on `geoJSON=true` parametri joka muuttaa vastauksen muodon. Kyseinen parametri vaatii, että ryhmittelytekijänä (aggregateBy) täytyy olla mukana yhdet (ja vain yhdet) koordinaatit. Valittavissa ovat seuraavat ryhmät:

**Havainnon bounding box ykj, etrs tai wgs84 koordinaatistoissa**

```
gathering.conversions.euref.latMax
gathering.conversions.euref.latMin
gathering.conversions.euref.lonMax
gathering.conversions.euref.lonMin

gathering.conversions.wgs84.latMax
gathering.conversions.wgs84.latMin
gathering.conversions.wgs84.lonMax
gathering.conversions.wgs84.lonMin

gathering.conversions.ykj.latMax
gathering.conversions.ykj.latMin
gathering.conversions.ykj.lonMax
gathering.conversions.ykj.lonMin

```

**Havainnon keskipiste wgs84 koordinaatistossa**

```
gathering.conversions.wgs84CenterPoint.lat
gathering.conversions.wgs84CenterPoint.lon

```

**Erikokoiset YKJ-ruudut** (100kmx100km, 10km x 10km, 1km x 1km) - joko keskipisteen mukaan määriteltynä tai siten että havainto on mukana ainoastaan jos on aidosti kokonaan ko ruudun sisällä

```
gathering.conversions.ykj100km.lat
gathering.conversions.ykj100km.lon

gathering.conversions.ykj100kmCenter.lat
gathering.conversions.ykj100kmCenter.lon

gathering.conversions.ykj10km.lat
gathering.conversions.ykj10km.lon

gathering.conversions.ykj10kmCenter.lat
gathering.conversions.ykj10kmCenter.lon

gathering.conversions.ykj1km.lat
gathering.conversions.ykj1km.lon

gathering.conversions.ykj1kmCenter.lat
gathering.conversions.ykj1kmCenter.lon

gathering.conversions.ykj50km.lat
gathering.conversions.ykj50km.lon

gathering.conversions.ykj50kmCenter.lat
gathering.conversions.ykj50kmCenter.lon

```

**WGS84 “ruudut”** 1 asteen, 0.5 asteen, 0.1 asteen, 0.05 asteen mukaan ryhmiteltynä

```
gathering.conversions.wgs84Grid005.lat
gathering.conversions.wgs84Grid005.lon

gathering.conversions.wgs84Grid01.lat
gathering.conversions.wgs84Grid01.lon

gathering.conversions.wgs84Grid05.lat
gathering.conversions.wgs84Grid05.lon

gathering.conversions.wgs84Grid1.lat
gathering.conversions.wgs84Grid1.lon

```

Eräs sinulle tärkeä rajaustekijä lienee `coordinateAccuracyMax`, jolla voi rajata tarkoitukseesi liian epätarkat havainnot pois tuloksista.

- YKJ:lla tarkoitetaan KKJ yhtenäiskoordinaatistoa: [Yhtenäiskoordinaatisto (YKJ) | Suomen Lajitietokeskus](https://laji.fi/theme/ykj)
- EUREF on sama kuin ETRS-TM35FIN

Sinun tarkoituksiisi sopinee tehdä ryhmittely täsmällisten bounding box tai täsmällisten keskipisteiden sijasta ruuduissa. Suomen havainnoista puhuttaessa YKJ -ruudut ovat ne mitä suosittelisin, koska ne saa aidosti metrikokoisina ruutuina.

Vastaamme mielellämme kaikkiin lisäkysymyksiin!

Esko / Lajitietokeskus
