Tilastotietokantojen px-tiedostojen rakenne muuttuu 8.6.2026. Jotta API-rajapintaan tehdyt kyselyt toimivat muutoksen jälkeen, niihin tulee tehdä korjauksia. Tällä sivulla kerromme, mitä muutoksia pitää tehdä ja mitä tietokantoja muutokset koskevat.
Muutokset koskevat lähes kaikkia tietokantojemme päivittyviä taulukoita. Muuttuvat taulukot tunnistaa nelimerkkisestä taulukko-ID:stä kuten 12tg.
Muutoksia on kolme:
Muutoksessa lyhennetään TABLEID- ja MATRIX-kenttien tiedot pääsääntöisesti pelkän ID-tunnisteen mittaisiksi. Muutoksen jälkeen tiedostonimi, TABLEID ja MATRIX tulevat olemaan identtiset.
Esimerkiksi työnvälitystilaston taulukossa tiedostonimi, TABLEID ja MATRIX muuttuvat seuraavasti:
ennen muutosta | muutoksen jälkeen | |
|---|---|---|
tiedostonimi | statfin_tyonv_pxt_12tg.px | 12tg.px |
TABLEID | statfin_tyonv_pxt_12tg | 12tg |
MATRIX | 010_12tg_2026 | 12tg |
Joissain tapauksissa tiedostonimi ei pelkästään lyhene, vaan ID:n perään tulee lisäksi tarkentava versiotunniste. Tämä muutos koskee lähinnä maksullisten tietokantojen vanhoja arkistotaulukoita. StatFin-taulukoissa tiedostonimiin ei tule lisäosia. StatFin-arkistokannassa näitä on mutta StatFin-arkistokannan tiedostonimiä ei toistaiseksi muuteta eikä lyhennetä. Tiedostonimimuutokset on listattu liitteessä 1.
Sama tiedosto sisältää myös aikamuuttujaa koskevat VARIABLECODE-muutokset, jotka kuvataan tarkemmin seuraavassa kappaleessa.
Jokaiselle taulukon muuttujalle lisätään muuttujatason koodi, joka toimii muutoksen jälkeen nykyisen muuttujanimen tilalla muuttujan tunnisteena api-kyselyissä. Alla on lueteltu eri muuttujille lisättävät muuttujakoodit.
Sisältömuuttujalle ”Tiedot” lisätään VARIABLECODE contentscode:
VARIABLECODE("Tiedot")="contentscode";VARIABLECODE[sv]("Uppgifter")="contentscode";VARIABLECODE[en]("Information")="contentscode";Aikamuuttujalle lisätään aikamuuttujan syklin mukainen VARIABLECODE. Seuraavassa on esimerkit muutamasta aikamuuttujasta.
Vuositaulukot:
VARIABLECODE("Vuosi")="timeperiod_y";
VARIABLECODE[sv]("År")="timeperiod_y";
VARIABLECODE[en]("Year")="timeperiod_y";
Kuukausitaulukot:
VARIABLECODE("Kuukausi")="timeperiod_m";
VARIABLECODE[sv]("Månad")="timeperiod_m";
VARIABLECODE[en]("Month")="timeperiod_m";
Vuosineljännestaulukot:
VARIABLECODE("Vuosineljännes")="timeperiod_q";
VARIABLECODE[sv]("Kvartal")="timeperiod_q";
VARIABLECODE[en]("Quarter")="timeperiod_q";
Luokitteleville muuttujille lisätään VARIABLECODE, joka on kyseisen luokituksen tai arvotasoisen koodiston tunniste.
Esimerkki aluemuuttujasta:
VARIABLECODE("Alue")="alue_23_20260101";
VARIABLECODE[sv]("Område")="alue_23_20260101";
VARIABLECODE[en]("Region")="alue_23_20260101";
Lisättävät VARIABLECODEt on kuvattu seuraavissa tiedostoissa. Aikamuuttujat sisältyvät samaan tiedostoon, jossa on kuvattu edellisessä kohdassa kuvatut tiedostonimimuutokset.
Joissain tapauksissa analyysimuuttujan arvotasoisille koodeille lisätään jokin etuliite. Analyysimuuttujalla tarkoitetaan muuttujaa ”Tiedot”.
Esimerkiksi tieliikenneonnettomuuksia koskevassa StatFin-taulukossa 111e tietomuuttuja ”kuol” muuttuu muotoon ”ton-kuol”.
Näitä muutoksia ei tule kaikkiin taulukoihin. Lisättävät etuliitteet on kuvattu seuraavassa tiedostossa.
URL: https://pxweb2.stat.fi/PxWeb/api/v1/fi/StatFin/ton/statfin_ton_pxt_111e.px
{
"query": [
{
"code": "Onnettomuustyyppi",
"selection": {
"filter": "item",
"values": [
"0",
"2"
]
}
},
{
"code": "Nopeusrajoitus",
"selection": {
"filter": "item",
"values": [
"1",
"5"
]
}
},
{
"code": "Kuukausi",
"selection": {
"filter": "item",
"values": [
"2026M04"
]
}
},
{
"code": "Tiedot",
"selection": {
"filter": "item",
"values": [
"kuol",
"loukv"
]
}
}
],
"response": {
"format": "json-stat2"
}
}
URL: https://pxweb2.stat.fi/PxWeb/api/v1/fi/StatFin/ton/111e.px
{
"query": [
{
"code": "onnettomuustyyp_2_20200101",
"selection": {
"filter": "item",
"values": [
"0",
"2"
]
}
},
{
"code": "nopeusrajoitus_2_20200101",
"selection": {
"filter": "item",
"values": [
"1",
"5"
]
}
},
{
"code": "timeperiod_m",
"selection": {
"filter": "item",
"values": [
"2026M04"
]
}
},
{
"code": "contentscode",
"selection": {
"filter": "item",
"values": [
"ton-kuol",
"ton-loukv"
]
}
}
],
"response": {
"format": "json-stat2"
}
}
statfin_ton_pxt_111e.px
TABLEID="statfin_ton_pxt_111e";
MATRIX="001_111e_2026m04";
CODES("Tiedot")="konn","kuolonn","loukonn","loukvonn","kuol","louk","loukv";
CODES[sv]("Uppgifter")="konn","kuolonn","loukonn","loukvonn","kuol","louk","loukv";
CODES[en]("Information")="konn","kuolonn","loukonn","loukvonn","kuol","louk","loukv";
111e.px
TABLEID="111e";
MATRIX="111e";
VARIABLECODE("Onnettomuustyyppi")="onnettomuustyyp_2_20200101";
VARIABLECODE[sv]("Typ
av olycka")="onnettomuustyyp_2_20200101";
VARIABLECODE[en]("Type
of accident")="onnettomuustyyp_2_20200101";
VARIABLECODE("Nopeusrajoitus")="nopeusrajoitus_2_20200101";
VARIABLECODE[sv]("Hastighetsbegränsning")="nopeusrajoitus_2_20200101";
VARIABLECODE[en]("Speed
limit")="nopeusrajoitus_2_20200101";
VARIABLECODE("Kuukausi")="timeperiod_m";
VARIABLECODE[sv]("Månad")="timeperiod_m";
VARIABLECODE[en]("Month")="timeperiod_m";
VARIABLECODE("Tiedot")="contentscode";
VARIABLECODE[sv]("Uppgifter")="contentscode";
VARIABLECODE[en]("Information")="contentscode";
CODES("Tiedot")="konn","kuolonn","loukonn","loukvonn","ton-kuol","ton-louk","ton-loukv";
CODES[sv]("Uppgifter")="konn","kuolonn","loukonn","loukvonn","ton-kuol","ton-louk","ton-loukv";
CODES[en]("Information")="konn","kuolonn","loukonn","loukvonn","ton-kuol","ton-louk","ton-loukv";
Tarvittavat tiedosto- ja muuttujatasoiset muutokset on listattu kolmeen tiedostoon.
Toisessa ja kolmannessa tiedostossa ei ole kytköstä tiedostotasolle, vaan ne on tarvittaessa kytkettävä/yhdistettävä ensimmäiseen listaukseen "Taulukon ID"-sarakkeiden kautta.
Otamme tänä vuonna käyttöön uuden tehokkaamman avoimen datan rajapinnan. Uuteen rajapintaan voi tutustua beta-versiossa, joka julkaistaan kesäkuun ensimmäisellä viikolla.
Rajapinnan beta-versiosta on saatavilla julkaistava data heti julkaisuhetkellä, mutta rajapintaa kehitetään edelleen, jonka vuoksi hetkelliset katkokset ja muutokset määrittelyissä ovat mahdollisia.
Tämä sisältö ei näy, jos olet estänyt evästeiden käytön. Jos haluat nähdä sisällön, tarkista evästeasetuksesi.