Tietomallin uudistus

Julkaistu 22.5.2026: Tietomallikaavio: metsävara- ja elinympäristökuviot, versio 2.1.2

Esimerkkiaineistoa metsävara- ja elinympäristökuvioista on nyt päivitetty ja tietomallikaaviosta julkaistu uusi versio (linkki tekstin lopussa).

Aikataulu tuleville muutoksille

Uuden tietomallin mukainen metsävara- ja elinympäristötiedon jakelu GeoPackagen ja GeoServer-rajapintojen kautta alkaa 1.9.2026. Nyt jaossa olevat GeoPackagen esimerkkiaineistojen linkit toimivat jatkossa myös tuotannon aineistolle. Käyttäjä voi siis rakentaa omat päivitystoimintonsa näihin GeoPackagen esimerkkiaineiston (karttalehti, kunta, maakunta) kansioihin.

Nykyinen ja uusi tietomalli ovat GeoPackagen ja GeoServer-rajapintojen osalta käytössä rinnakkain vuoden 2027 kesäkuun loppuun asti. GeoPackage löytyy vielä tämän jälkeen vanhalla tietomallilla historioinnin puolelta, mutta päivittyvä aineisto poistuu käytöstä. Samassa yhteydessä myös muut nykyisen jakelun muodot poistuvat.

GeoPackage-aineistopaketit

Huhtikuun alussa julkaistun GeoPackage-esimerkkiaineiston runko on pysynyt muuten samana, mutta lisäsimme tietomalliin vielä muodostumisen hetkellä käytössä olleet koodistot omaan tauluunsa. Tällöin käyttäjä saa aineistossa käytettyjen koodien selitteet samasta GeoPackagesta, jolloin niitä ei tarvitse erikseen hakea toisesta tietolähteestä.

GeoPackagen mukana tulevat koodistot ja selitteet auttavat tulevaisuudessa, kun esimerkiksi koodistot vaihtuvat uudempaan versioon. Tällöin uudet koodistot tulevat automaattisesti GeoPackagen mukana, eikä käyttäjän tarvitse erikseen huomioida muutosta. Hyötyä on myös aikanaan, kun ladataan vanhoja historioituja GeoPackage-aineistoja. Vanhoista aineistoista käyttäjän ei tarvitse erikseen päätellä, mitkä koodistojen versiot on olleet käytössä luontihetkellä esimerkiksi vuosi sitten.

Jaossa olevat staattiset erimerkkiaineistot sisältävät nyt uusien koodistojen lisäyksen. Esimerkkiaineisto on saatavilla samasta paikasta kuin aikaisemmatkin. Samat linkit tulevat toimimaan myös tuotannon aineistolle latauspaikkana. 

Linkit esimerkkiaineistoihin:

• Metsävarakuviot (karttalehti, kunta, maakunta)
• Elinympäristökuviot (karttalehti, kunta, maakunta)

GeoServer-rajapinnat (WMS/WFS)

GeoServer-rajapintatuotteiden uudistaminen etenee suunnitellusti. Toteutuksen on tarkoitus valmistua kesän aikana ja syksyllä on mahdollista aloittaa jakelu tuotantoon uudistetulla tietomallilla. GeoServer-rajapintojen uudistus noudattelee GeoPackage-aineistopakettien uudistuksen linjaa, jossa metsävarakuviot ja elinympäristökuviot jaetaan omina itsenäisinä aineistoinaan. Käyttäjälle tämä tarkoittaa, että:

• metsävaratiedosta saa kuvioon liittyvän puusto-, kasvupaikka- ja toimenpide-ehdotustiedon
• elinympäristötiedosta saa ML 10 §, elinympäristö ja muu arvokas elinympäristö -kuvioon tai kohteeseen liittyvän puusto- ja kasvupaikkatiedon sekä kohteeseen liittyvän elinympäristö- ja luontotiedon.

GeoServer-rajapintajakelun tietomalli on suppeampi verrattuna GeoPackagen sisältöön. Uudistuksessa tietomallin sisältöä uusittiin vain maltillisesti ja tuleva sisältö noudattelee pitkälti väistyvän tietomallin sisältöä. GeoServer-rajapinnan tieto päivittyy lähes reaaliajassa käyttäjälle. GeoServer-rajapinnoista ei tulla jakamaan mallia tai demoympäristöä, vaan käyttäjät voivat aikanaan ottaa käyttöönsä suoraan tuotantoversion.

Julkaistu 9.4.2026: GeoPackage-esimerkkiaineisto, sisältöohjeet ja Tietomallikaavio metsävara- ja elinympäristökuviot, versio 2.1.1

Avoimen tiedon käyttäjille on nyt saatavilla ensimmäinen esimerkkiaineisto sekä metsävara- että elinympäristökuviosta GeoPackagen karttalehtijaotteluna. Aineisto on staattinen malliaineisto, jota avoimen tiedon käyttäjät voivat alkaa tutkia ja suunnitella siihen liittyviä muutoksia omissa käyttöympäristöissään.

Uuden tietomallin GeoPackagen tueksi olemme laatineet myös sisältöohjeet. Toivomme, että ohjeet auttavat hahmottamaan uuden tietomallin sisältöä ja millaisia sääntöjä tai poikkeuksia Metsäkeskuksen jaettavassa tietomallissa on.

Seuraavaksi teemme GeoPackage-toteutuksen loppuun ja varmistamme tuotantoprosessin toimivuuden. Jatkuvasti päivittyvän GeoPackage-jakelun käynnistämisen tavoiteaikataulu on syyskuu 2026. Aineisto tullaan jakamaan karttalehti-, kunta- ja maakunta-jaottelulla, kuten aikaisemminkin.

Myös GeoServerin WMS- ja WFS-toteutus etenee taustalla. GeoServer tulee käyttöön arviolta kesän jälkeen. Kutsurajapintojen tekninen toteutus on määrittelyssä ja sen etenemiseen vaikuttaa myös metsätietostandardin aikataulu. Sekä metsätietostandardin että Metsäkeskuksen kutsurajapinnan käyttämä formaatti tulee muuttumaan XML:stä GeoJSONiin. Näistä tiedotamme lisää myöhemmin.

Linkit esimerkkiaineistoihin:

• Metsävarakuvio-karttalehti
• Elinympäristökuvio-karttalehti

Julkaistu 16.12.2025: Tietomallikaavio: metsävara- ja elinympäristökuviot, versio 2.1

Metsäkeskus sai marraskuun aikana valmiiksi taustaselvityksen metsävara- ja elinympäristökuvion tietomallin uudistamiselle. Selvityksen myötä saatiin päätettyä lopullinen rakenne tietomalliin. Uusi tietomalli on Excel-tiedostoversio 2.1:ssä, josta käyttäjä voi tarkastella sen rakennetta ja tietosisältöä. Tekeillä on myös erillinen ohjeistus, joka sisältää tarkempaa tietoa uudesta tietosisällöstä sekä huomioita uuden aineiston käyttöä varten.

Uuden metsävara- ja elinympäristökuvion tietomallin mukainen uudistus aloitetaan GeoPackage-aineistoista. Uudistamistyöt on aloitettu joulukuun aikana ja ne jatkuvat ensi vuoden maaliskuulle. Metsäkeskus varaa vielä aikaa testaamiselle, jolloin uusi GeoPackage-aineistopakettien jakelu olisi tuotantokäytössä arviolta toukokuun aikana. 

Suunnitelmissa on jakaa staattinen malliaineisto helmikuun aikana, jolloin avoimen metsä- ja luontotiedon käyttäjillä olisi mahdollisuus tehdä sen pohjalta valmiiksi omia toimintojaan ennen uuden GeoPackagen tuotantoon vientiä. Samassa yhteydessä jaetaan sisältöä koskeva ohjeistus. 

WMS/WFS-rajapintojen määrittelyt ovat myös valmistuneet tietosisältöjen osalta. Ne noudattelevat GeoPackagen mallia, jossa metsävarakuvio ja elinympäristökuvio ovat omia itsenäisiä aineistojaan, mutta niiden sisältö on suppeampi. Niiden toteutuksen aikataulu tarkentuu myöhemmin.

Julkaistu 7.11.2025: Kohdennettu palautekysely

Metsäkeskus haki syyskuun aikana kohdennettua palautetta avoimen metsävara- ja elinympäristötiedon jakelun uudistuksesta.

Julkaistu 19.9.2025: Tietomallikaavio: metsävara- ja elinympäristökuviot, versio 2.0

Uudessa tietomallissa metsävaratieto ja elinympäristötieto jaetaan erikseen. Käyttäjälle tämä tarkoittaa, että:

• Metsävaratiedosta saa siihen kuvioon liittyvän puusto-, kasvupaikka- ja toimenpide-ehdotustiedon
• Elinympäristötiedosta saa ML 10 §, elinympäristö ja muu arvokas elinympäristö -kuvioon tai kohteeseen liittyvän puusto- ja kasvupaikkatiedon sekä kohteeseen liittyvän elinympäristö- ja luontotiedon.

ML 10 § ja muu arvokas elinympäristö -kuviot ovat geometrialtaan vastaavia kuin metsävarakuviot. Erona on, että elinympäristökuviolla ovat lisäksi luontotietoon liittyvät taulut. Elinympäristökuvioille ei simuloida hakkuutoimenpiteitä ja tiedon lisäykset tehdään ainoastaan manuaalisesti.

Lisätietoa

Lisätietoa uudistuksesta avoimen metsä- ja luontotiedon käyttäjille:

Julkaistu 22.5.2026: Metsätietostandardin mukaisen metsävaratiedon rajapintauudistus

Metsäkeskus uudistaa metsätietostandardin jakelun REST-kutsurajapinnan toteutuksen. Metsäkeskuksella on käytössä metsätietostandardin XML-sanomamuodossa välitettävän metsävarasanoman versiot 1.8 ja 1.9 REST-rajapintatoteutuksena. Metsätietostandardi siirtyy jatkossa GeoJSON-muotoon. Uudistuksen yhteydessä Metsäkeskus luopuu XML-sanomaversioista ja siirtyy käyttämään pelkästään GeoJSON-rakennetta. XML-sanomaversion poistumisen syynä on suurempi metsävara- ja elinympäristötiedon jakamisen uudistus. 

GeoJSON-sanoman rakenteesta vastaa Sitowise: Metsätietostandardit - julkaisusivusto (Sitowise.com). Metsäkeskuksen vastuulla puolestaan on toteuttaa rajapinnan tekninen uudistus. Metsäkeskus on ollut aktiivisesti mukana myös sanoman rakenteen uudistuksessa, jotta metsävaratiedon jakelun uudistus toteutuisi käyttäjien kannalta mahdollisimman sujuvasti.

Metsäkeskuksella on ollut käytössä avoimena tietona metsävaratietoa palauttava REST-rajapinta sekä metsäalan ammattilaisille tarkoitettu suostumuksellisen metsävaratiedon REST-rajapinta. Uudistuksessa kaikille avoin rajapinta toteutetaan hyvin pitkälti samoin kuin ennenkin, mutta siihen lisätään uusia toimintoja. Metsäalan ammattilaisille tarkoitettuun suostumuksellisen metsävaratiedon rajapinnan toteutukseen tehdään suurempia muutoksia. Uutena ominaisuutena on tulossa oma toiminnallisuus metsävarakuviotietojen päivittymiseen. Alla ovat tarkemmat kuvaukset uudistettavista palveluista.

Aikataulu muutoksille

Metsätietostandardin REST-rajapinnan uudistuksen tavoiteaikatauluna on saada uuden metsätietostandardin muotoisen GeoJSON-sanoman jakelu tuotantoon vuoden 2026 lokakuuhun mennessä. Suostumuksellisen REST-rajapinnan vastaava tavoiteaikataulu on vuoden 2026 loppuun mennessä. Metsävarakuvioiden suodatustoiminnon REST-rajapinta on uusi toiminto ja tehdään valmiiksi muiden toteutusten jälkeen.

Metsätietostandardin REST-rajapinnan uudistus

Metsävarakuvioiden palautukseen tarkoitettu metsätietostandardin uudistettu REST-rajapinta palauttaa kysyjälle aluemaisena tai kuvio-ID:n perusteella metsävarakuvioita GeoJSON-muodossa. Rajapinnan toiminnallisuudet muodostuvat viidestä eri tavasta saada metsävarakuvioiden tietoja. 

Uutena ominaisuutena on mahdollista pyytää rajapinnasta metsävarakuvioita suoraan metsävarakuvion kuvio-ID:n avulla. Tarkoituksena on, että rajapinta tukee muista formaateista tai palveluista saadun tiedon avulla jopa yksittäisen metsävarakuvion tietojen päivittämistä tämän REST-rajapinnan kautta.

1. Haku kuviolla (multipolygon)

• Muodostaa GeoJSON-sanoman niiden metsävarakuvioiden pohjalta, jotka leikkaavat parametrina annettua monikulmiota (WKT-monikulmio). Vastaus on metsätietostandardin mukainen GeoJSON. Uutena ominaisuutena mahdollisuus hakea. multipolygonilla.

2. Haku kuviolla (ZIP) (multipolygon)

• Toiminto on samanlainen kuin haku kuviolla, lukuun ottamatta sitä, että vastaus palautetaan tiedostona ja toiminnolla on ylimääräinen parametri format, joka määrittelee, pakataanko tiedosto. Uutena ominaisuutena mahdollisuus hakea multipolygonilla.

3. Haku kuvio-ID:llä (uusi) 

• Muodostaa GeoJSON-sanoman niiden kuvio-ID-tietojen pohjalta, jota kutsussa pyydetään. Kutsuja voi kutsua suoraan metsävaratietoja kuvio-ID:n perusteella. Vastaus on metsävaratiedot metsätietostandardin mukaisena GeoJSON-sanomana.

4. Haku kuvio-ID:llä (ZIP) (uusi)

• Toiminto on samanlainen kuin haku kuvio-ID:llä, lukuun ottamatta sitä, että vastaus palautetaan tiedostona ja toiminnolla on ylimääräinen parametri format, joka määrittelee, pakataanko tiedosto.

5. Haku karttalehdellä

• Karttalehtitunnuksen GeoJSON-sanoma muodostetaan niiden metsävarakuvioiden pohjalta, jotka leikkaavat parametrina annettua karttalehteä vastaavaa monikulmiota.

Suostumuksellisen tiedon REST-rajapinnan uudistus

Metsäalan ammattilaisille tarkoitettu rajapinta on niiden tietojen hakemista varten, joihin metsäalan toimija on saanut metsänomistajalta suostumuksen. Suostumus on aina metsänomistajan itsensä antama suostumus kiinteistön metsävaratietojen ja henkilötietojen yhdistämiseen tietylle toimijalle. Suostumus on myös aina metsänomistaja- ja kiinteistökohtainen. Haettavaan tietoon voi liittyä useita kiinteistöjä, joihin vain osaan käyttäjä on antanut suostumuksen. Tällöin haku palauttaa ne kiinteistöt, joihin suostumus löytyy.

Aikaisemmin jaettiin samassa XML-sanomassa sekä henkilön yhteystiedot että metsävaratiedot. Uudistettavassa palvelussa jaetaan jatkossa metsänomistajien tietojen lisäksi vain kyseessä olevan kiinteistön metsävarakuvioiden kuvio-ID:t. Jatkossa metsävaratiedot saa ainoastaan uudistettavasta metsätietostandardin REST-rajapinnasta, joka on kaikille avoin.

Uudistuksen yhteydessä Metsäkeskus luopuu Suomi.fi-palveluväylästä. Toteutukseen tulee jokin nykyaikainen tietoturvallinen yhteys, joka tarkentuu myöhemmin. Liikenne kuitenkin kulkee jatkossa suoraan toimijan ja Metsäkeskuksen välillä, eikä kulje liityntäkatalogin kautta.

Rajapintaan kaksi uutta toiminnallisuutta:

smlrest/list/

• Käyttötapauksessa listataan luettelo yritykselle saatavilla olevista kiinteistöistä Suomessa. Listataan kiinteistöt, joihin käyttäjällä on suostumus ja paluusanoma on vain lista kiinteistötunnuksista (JSON). Käyttäjä voi kysyä voimassa olevia suostumuksia joko koko Suomen kiinteistöistä tai kunnittain. 

smlrest/data/

• Käyttötapauksessa rajapinta palauttaa kiinteistön omistajien tietoja. Hakuavaimena voi olla joko kiinteistötunnus tai y-tunnus, joiden perusteella listataan ne metsänomistajien tiedot, joilla on voimassa oleva suostumus kiinteistölle. Tiedot listataan kiinteistöittäin ja kiinteistön alle lisätään kyseisen kiinteistön toimijalle voimassa suostumusten antaneiden metsänomistajien tiedot. Kiinteistön alle listataan myös kiinteistöä koskevat metsävarakuvio-ID:t.

Metsävarakuvioiden suodatustoiminto REST-rajapinnassa (UUSI)

Uutena toimintona tuomme avoimen metsä- ja luontotiedon käyttäjille REST-rajapintaan palvelun, josta voi kysyä muutoksia metsävarakuvioiden tiedoissa. Tällöin käyttäjä voi päivittää vain ne kuviot, joissa on tapahtunut muutoksia tietyllä aikavälillä. Tällä toiminnallisuudella haluamme parantaa käyttäjäkokemusta ja vähentää ylimääräistä aineistojen lataamista.

Palvelu toimii yhdessä muiden Metsäkeskuksen tietotuotteiden kanssa. Käyttäjä voi esimerkiksi tarkistaa, kuinka paljon päivityksiä on tullut ja päättää niiden määrän perusteella, lataako muutokset metsätietostandardin REST-rajapinnasta vai massalatauksena GeoPackage-aineistopakettien jakelusta. 

Palvelu palauttaa listauksen hakutekijöiden perusteella metsävarakuvioiden kuvio-ID:t. Kuvio-ID:ien perusteella käyttäjä voi hakea tiedot toisella hakutoiminnolla Metsätietostandardin REST-rajapinnan Haku kuvio-id -toiminnolla. Alla on kuvattu toiminnallisuudet, jotka olemme katsoneet mahdollisiksi toteuttaa ja jotka auttavat käyttäjiä parhaiten tiedon päivittymistarpeissa. 

Metsävarakuvioiden suodatustoiminnot (UUSI)

STANDNEW (Uudet kuviot) 

• Käyttäjä antaa pakollisena arvona aikavälin ja valinnaisena kunnan, jonka alueelta muutoksia tarkastellaan. Koostetaan metsävarakuviot lisäysajan perusteella. Kuvio-ID listataan. 

STANDDELETE (Poistuneet kuviot) 

• Käyttäjä antaa pakollisena arvona aikavälin ja valinnaisena kunnan, jonka alueelta muutoksia tarkastellaan. Koostetaan poistuneet metsävarakuviot. Kuvio-ID listataan. 

STANDUPDATE (Muuttuneet kuviot) 

• Käyttäjä antaa pakollisena arvona aikavälin ja valinnaisena kunnan, jonka alueelta muutoksia tarkastellaan. Muutoksissa tarkastellaan metsävarakuvion päivitysaikoja. Kuvio-ID listataan. 

INVENTORYUPDATE (Inventointipuustotietojen päivittyminen) 

• Käyttäjä voi tarkastella metsävarakuvion inventointitietojen päivittymistä. Pakollinen arvo on aikaväli, jolta tarkastelua tehdään. Paluusanoma listaa vain hakutulosten kuvio-ID:t. 

CUTTINGSTATUS (Hakkuun toteutuksen tila)

• Käyttäjälle annetaan tietoa hakkuun tilan muutoksista tietyllä aikavälillä. Käyttäjä voi esittää toteutuksen tilan koodin ja aikavälin, josta listataan paluusanomana kuvio-ID:t.

SILVICULTURESTATUS (Metsänhoitotyölajin toteutuksen tila)

• Käyttäjälle annetaan tietoa metsänhoitotyön tilan muutoksista tietyllä aikavälillä. Käyttäjä voi esittää toteutuksen tilan koodin ja aikavälin, josta listataan paluusanomana kuvio-ID:t.

Julkaistu 22.5.2026: Metsänkäyttöilmoituksen tietomalli uudistuu

Metsäkeskus uudistaa metsänkäyttöilmoituksen tietomallin sisällön ja rakenteen. Käytännössä tämä koskee Geoserver-rajapintatuotteita (WMS/WFS) sekä aineistopakettia (GeoPackage). Avoimen metsä- ja luontotiedon käyttäjille uudistus tarkoittaa muutoksia tiedon ja aineiston käsittelyssä sekä jatkossa siirtymistä uuden tuotteen käyttöön.

Syy muutokselle on Metsäkeskuksen järjestelmäuudistus. Metsäkeskus uudistaa metsänkäyttöilmoitusten käsittelyjärjestelmän, mikä samalla uudistaa tiedon käsittelyn nykyajan tekniset tarpeet huomioiden. Avoimen metsä- ja luontotiedon metsänkäyttöilmoitusten tietomalliin on sisällytetty vain nykypäivänä tarpeelliset tiedot.

Aikataulu muutoksille

Avoimen metsä- ja luontotiedon tietomallin uudistus on vahvasti sidoksissa tuotantojärjestelmän aikatauluihin. Avoimen metsä- ja luontotiedon käyttäjien on hyvä huomioida, että muutos tehdään kertaluontoisesti vanhasta uuteen. Käyttäjälle tämä tarkoittaa sitä, että nykyinen tietomallin aineiston päivittyminen katkeaa samana päivänä, kun uusi metsänkäyttöilmoitusten järjestelmä otetaan käyttöön. 

Väistyvä rajapinta jää vielä määrittelemättömäksi ajaksi saataville, mutta sen aineisto ei päivity. Muutoksen yhteydessä uudesta tietomallista on tarjolla Uudistamishakkuut ja jatkuvan kasvatuksen hakkuut <= 40 v sekä Muut kasvatushakkuut <= 10 v. Jos vanhasta järjestelmästä siirrettävät aikamääreet riittävät omassa toiminnassasi, voit siirtyä suoraan uuteen tietomalliin etkä välttämättä tarvise kahta rinnakkaista mallia.

Alustavana suunnitelmana on, että uusi tietomalli tulisi käyttöön aikaisintaan vuoden vaihteen tienoilla. Aikataulu tarkentuu myöhemmin. 

Alla on uuden tietomallin rakennetta ja sisältöä kuvaavan tiedosto, jonka perusteella avoimen metsä- ja luontotiedon käyttäjät voivat alkaa suunnitella omia muutoksiaan. Pyrimme saamaan uuden tietomallin tuotteet myös mahdollisimman nopeasti tuotantoon, jotta käyttäjillä on mahdollisuus siirtyä näiden käyttöön hyvissä ajoin. Aineiston päivittyminen alkaa vasta, kun uusi tuotantojärjestelmä otetaan käyttöön.

Alustava toteutussuunnitelma

1. Metsäkeskus toteuttaa uuden metsänkäyttöilmoituksen Geoserver-rajapinnan ja GeoPackage-tuotteet vuoden 2026 loppuun mennessä. Tietomallin rakenne ja sisällön kuvaukset ovat saatavilla etukäteen. 
2. Uuden tietomallin avoimen tiedon linkit tuodaan saataville heti, kun mahdollista.
3. Uuden käsittelyjärjestelmän käyttöönoton yhteydessä päivitykset päättyvät väistyvään metsänkäyttöilmoituksen Geoserver-rajapinnan ja GeoPackagen tuotteissa. Päivittyvä metsänkäyttöilmoitusaineisto siirtyy uuden tietomallin mukaisiin tuotteisiin.
4. Siirtymäajan jälkeen poistetaan vanhan tietomallin mukaiset rajapintojen julkaisut. GeoPackage uudelleennimetään ja se jää staattiseksi aineistoksi jakoon avoimen tiedon käyttäjille.
5. Poistetaan vanhat rajapinnat, jonka jälkeen käytössä on uuden tietomallin mukainen GeoServer-rajapinta ja GeoPackage.