Kehittäjille

Rajapinnat löytyvät osoitteesta api.metsanhoidonsuositukset.fi(ulkoinen linkki)

Katso myös: Käyttöehdot(ulkoinen linkki)

Lisätietoja metsätietopalvelujen kehittäjille antavat ylläpitäjät Tapiossa: mhspalaute@tapio.fi, kati.kontinen@tapio.fi tai petri.latva-kayra@tapio.fi.

Metsänhoidon suositusten rakenne on jaettu kahteen kategoriaan: Metsätilan hoito ja Metsänhoidon toimenpiteet (aiempi nimi Suositukset aiheittain). Metsätilan hoito -artikkeleista löytyy tietoa metsätilan hoidon suurempiin suuntaviivoihin, kuten metsänhoidon perusteita ja metsänomistajan tavoitteiden painottaminen metsätilan hoidossa. Metsänhoidon toimenpiteet -kategoria kokoaa artikkeleita aihealueittain.

Metsänhoidon toimenpiteitä kuvaavien artikkeleiden rakenne koostuu neljästä osiosta:

1. Kuvaus-osiossa annetaan yleinen kuvaus toimenpiteestä ja sen tavoitteista, hyödyistä sekä vaikutuksista.
2. Päätöksenteko-osiossa kerrotaan artikkelin aiheen läpileikkaavat kestävyysteemat. Metsänomistaja saa niistä tietoa toimenpiteiden vaikutuksista talouteen, luonnon monimuotoisuuteen, virkistyskäytön mahdollisuuksiin ja ilmastonmuutoksen hillintään.
3. Toteutus-osiossa kuvataan asiat, jotka auttavat toimenpiteen toteutuksessa. Lakeihin ja sertifiointiin, vesien laadun turvaamiseen, ilmastonmuutokseen sopeutumiseen, riistan huomiointiin ja työturvallisuuteen liittyvät asiat ovat osa toteutusta. 
4. Yleistietoa-osiosta löytyvät suositusten laadinnassa käytetyt lähteet.  

Palvelun rajapinnasta eri tyyppiset osiot löytyvät nimillä: 

1. Kuvaus = Operation description 
2. Päätöksenteko = Good practice 
3. Toteutus = Realisation 
4. Yleistietoa = Reference 
5. Kuvat = Media
6. Metsätilan hoito -artikkelit = Article
7. Metsänhoidon toimenpiteet -kategoria = Category
8. Taulukot = Table
9. Yleissivut, tietoa metsänhoidon suosituksista ja niiden laadinnasta = Page

Rajapintoja on rakennettu kaksi: GraphQL API ja REST API. Tässä yhteydessä kuvataan ainoastaan REST APIn käyttöä lyhyesti.

Jos haetaan tietoa esimerkiksi harvennuksesta: 

REST API: Otsikko operation-description, valitse GET-painike kohdassa /operation-descripions ja sen jälkeen Try it out.

Rajapinnasta haetaan kaikki toimenpiteen kuvaukset ja sen jälkeen poimitaan kyseisen toimenpiteen kuvauksen id ja haetaan sillä: GET /operation-descriptions/ {id}. Haku voidaan tehdä myös työlajikoodilla: vaihda alalaidasta ID valinnaksi operation TypeCode.

ID on järjestelmän sisäinen ID, jota ei voi tietää ennalta. Mikäli kutsuja haluaa ketjuttaa, esimerkiksi hakemalla ensin metsätietostandardin koodilla toimenpiteen kuvauksen (haku by = operationTypeCode esim https://api.metsanhoidonsuositukset.fi/v1/operation-descriptions/100?by=operationTypeCode(ulkoinen linkki) ), saa vastauksena kokonaisuuden, jossa on mukana myös järjestelmän sisäisiä ID:itä. Näitä voi käyttää jatkohauissa esimerkiksi toteutuksien kohdalla.

20.1.2023 OperationTypeCode -koodit, jotka tuottavat rajapinnasta tuloksen:

1 Ylispuiden poisto
2 Ensiharvennus
3 Harvennus
4 Kaistalehakkuu 
7 Suojuspuuhakkuu
8 Siemenpuuhakkuu
12 Väljennyshakkuu
14 Poimintahakkuu 
15 Pienaukkohakkuu
100 Luontainen uudistaminen
200 Kylvö 
201 Männyn kylvö 
202 Kuusen kylvö 
203 Rauduskoivun kylvö 
204 Hieskoivun kylvö 
205 Haavan kylvö 
206 Harmaalepän kylvö
207 Tervalepän kylvö 
208 Muun havupuun kylvö
209 Muun lehtipuun kylvö 
300 Istutus
301 Männyn istutus 
302 Kuusen istutus 
303 Rauduskoivun istutus 
304 Hieskoivun istutus 
305 Haavan istutus 
306 Harmaalepän istutus
307 Tervalepän istutus 
308 Muun havupuun istutus
309 Muun lehtipuun istutus 
401 Raivaus
440 Haavan vesottumisen ennakkotorjunta 
450 Ennakkoraivaus 
501 Maanpinnan käsittely 
510 Laikutus 
511 Kaivurilaikutus
512 Yksittäisten kuokkalaikkujen tekeminen
521 Kääntömätästys 
522 Naveromätästys 
523 Laikkumätästys 
530 Äestys
531 Ristiinäestys
540 Säätöauraus
550 Ojitusmätästys 
601 Männyn täydennysistutus
602 Kuusen täydennysistutus
603 Rauduskoivun täydennysistutus 
604 Hieskoivun täydennysistutus 
605 Haavan täydennysistutus
606 Harmaalepän täydennysistutus
607 Tervalepän täydennysistutus 
608 Muun havupuun täydennysistutus
609 Muun lehtipuun täydennysistutus 
640 Mekaaninen heinäntorjunta 
650 Kemiallinen heinäntorjunta
701 Taimikonhoito ja -kunnostus 
740 Taimikonhoito
745 Taimikon varhaishoito
890 Taimikonharvennus
911 Kasvatuslannoitus
912 Terveyslannoitus 
940 Kunnostusojitus
950 Hakkuutähteiden korjuu 
951 Kantojen korjuu
970 Pystykarsinta

Yleinen huomio metsätietostandardin koodistoista: Tällä hetkellä haku onnistuu vain yhdistelmäkoodistolla OperationTypeType, jossa koodit on yhdistetty kyseisiin suosituksiin. Metsänhoidon suositusten sisältöä ja rajapintaa kehitetään edelleen, jotta eri metsätietostandardikoodistoilla haku mahdollistuisi. Kehittämishankkeesta voi lukea lisää Tapion verkkosivuilta(ulkoinen linkki).

Suomalaisen metsätietostandardin ansiosta metsäsektorin toimijat voivat kehittää ja käyttää yhteen- toimivia tietojärjestelmiä. Valmiit XML-skeemat sekä valmisteilla olevien XML-standardien luonnokset löytyvät metsätietostandardien julkaisusivuilta(ulkoinen linkki).

Palvelun etusivulla on hakemisto, jonka välilehdeltä Uusimmat viralliset versiot löytyy metsätietostandardien koodistot. Metsänhoidon suosituksissa on käytössä koodisto KOOD_V25.

Metsänhoidon suositukset -hanke tekee yhteistyötä standardin laatijoiden kanssa. Lisätietoa standardista ja sen laadinnasta löytyy Suomen metsäkeskuksen sivuilta(ulkoinen linkki).

Metsään.fi, lisätietoa metsänomistajalle(ulkoinen linkki) 

Suometsäosaaja.fi, upotukset verkkokurssiin(ulkoinen linkki) 

Metsänhoidon suositusten uutiskirje palvelukehittäjille pitää ajan tasalla palvelun kehittämisestä ja antaa vinkkejä käyttötapauksista. Tilaa kirje Tapion tilauslomakkeella(ulkoinen linkki), alin ruksipaikka,

Päivitetty viimeksi: 20.1.2023