Helsingin Sanomat julkaisee Suomen koronavirus-tartunnat ja niiden tiedossa olevat lähteet avoimena datana. HS on kerännyt aineiston julkisista lähteistä: tiedotustilaisuuksista, mediasta ja haastatteluista. Tällä hetkellä datan päälähde on THL:n tartuntatietorekisteri tartuntojen osalta, ja sairaanhoitopiirien, kuolemien sekä rokotusten osalta osalta HS:n oma datan keräys.
Jos THL:n rajapinnan käyttö kiinnostaa, kannattaa katsoa example-thl-parser-kansioon.
Dataa saa käyttää vapaasti niin kaupallisiin kuin yksityisiin tarpeisiin. Toivomme, että data tallennetaan paikallisesti tai välimuistitetaan, mikäli se on tarkoitus julkaista laajalle yleisölle.
HS avaa datan julkiseksi, jotta muut tiedotusvälineet, kehittäjät ja datavisualistit pystyisivät paremmin hahmottamaan koronaviruksen leviämistä Suomessa. Toiveena on, että yleisön tietoisuus viruksesta paranisi ja mahdollisuudet suojautua tartunnoilta sekä arvioida tartunnan riskejä perustuisivat mahdollisimman tarkkaan aineistoon.
THL on julkaissut omat datansa avoimena täällä. Datan julkaisun seurauksena suurin osa sairaanhoitopiireistä ei enää julkaise omia lukujaan, minkä johdosta HS:n aloittama tiedonkeruu ei enää kannata. Lisäksi THL:n rajapinnassa havainnot esitetään testauspäivän perusteella, kun HS:n alun perin keräämässä datassa havainnot olivat ilmoituspäivän mukaan.
Tämän johdosta HS:n data HS:n ensimmäisen rajapinnan takan ei enää päivity - sen synkronointi eri tavalla ilmoitetun datan kanssa ei käy järkeen. HS tarjoaa yhteensopivan rajapinnan THL:n datan päälle vanhan rajapinnan korvaajaksi. Lisäksi HS tarjoaa oman versionsa THL:n tartuntadatasta ja keräämänsä tiedot sairaalahoidossa olevista.
Suora rajapinta HS:n dataan (see in English below)
Viimeisimmän HS:n alun perin datan voi lukea osoitteesta https://w3qa5ydb4l.execute-api.eu-west-1.amazonaws.com/prod/finnishCoronaData
(kyllä, se on suora osoite AWS Lambdan API-gatewayhyn). GET-pyynnöllä pääsee. Tästä rajapinnasta voit lukea havaintoja
tartunnan saaneista, kuolleista ja parantuneista. Tieto kerätään eri lähteistä (THL:n raportit, sairaanhoitopiirien raportit).
Osoitteesta (https://w3qa5ydb4l.execute-api.eu-west-1.amazonaws.com/prod/finnishCoronaHospitalData) voit lukea tietoja sairaalahoidossa olevista. Tämä tieto on talletettu THL:n päivän raporteista. Esimerkkidataa täällä.
Osoitteesta (https://w3qa5ydb4l.execute-api.eu-west-1.amazonaws.com/prod/finnishCoronaData/v2) voit lukea HS:n muokkaaman, aiemman
finnishCoronaData-rajapinnan kanssa yhteensopivan dataobjektin havaistuista tartunnoista. kuolleista ja parantunteista.
Esimerkkidataa täällä. HUOM: kuolemat eivät enää päivity tähän rajapintaan, katso kohta päivityksestä
9.7.2021 alta.
Päivitys 28.12.2020
Ylläoleva v2-osoite on päivitetty poistamalla siitä infectionSource ja infectionSourceCountry -kentät. Muutos tehtiin, jotta rajapinnan
vastaukset mahtuisivat AWS-lambdan rajoihin. Suosittelemme siirtymään käyttämään yllä olevaa osoitetta sairaaladataan ja alla olevaa THL:n
tartuntadataan.
Suoraan itse käyttämämme THL:n data on luettavissa osoitteesta (https://w3qa5ydb4l.execute-api.eu-west-1.amazonaws.com/prod/processedThlData). Esimerkkidata täällä.
Testaukseen liittyvää dataa on tarjolla Suomen tasolla aikasarjana (https://w3qa5ydb4l.execute-api.eu-west-1.amazonaws.com/prod/thlTestData) ja viimeisin tieto sairaanhoitopiireittäin (https://w3qa5ydb4l.execute-api.eu-west-1.amazonaws.com/prod/hcdTestData).
Päivitys 8.1.2021
Osoitteesta (https://w3qa5ydb4l.execute-api.eu-west-1.amazonaws.com/prod/finnishVaccinationData) voit lukea tuoreimmat tiedot Suomen rokotustilanteesta. HS:n toimitus päivittää tietoa käsin sitä mukaa kun THL sitä julkaisee.
Päivitys 9.7.2021
THL muutti 23.6.2021 käytäntöjään sairaalahoidon ja kuolemien ilmoituksen suhteen. 23.6. asti sairaalahoidon ja kuolemien tiedot raportoitiin päivittäin (ja lopulta viikottain) THL:n verkkosivuilla HTML-taulukkona jonka raavimme omaan talteen. Tämä käytännön loputtua THL:n rajapinnat ovat olleet ainoa lähde sairaala- ja kuolematiedoille. Avointa rajapintaa on päivitetty seuraavasti:
Sairaaladatan osoite (https://w3qa5ydb4l.execute-api.eu-west-1.amazonaws.com/prod/finnishCoronaHospitalData) palautta dataa siten, että
23.6.2021 palautetaan dataa kuten ennen, jonka jälkeen siihen yhdistetään THL:n rajapinnoista saatava data. Tämä aiheuttaa sen että
datassa on pieni hyppäys 23.6. ja 24.6. välillä, sillä THL:n raportointikäytäntöjen mukaan tapahtumat sijoitetaan niiden tapahtumapäivälle (kun vanhassa
mallissamme tapahtumat sijoitettiin raportointipäivälle). THL:n rajapinnoista ei saa enää kuin kuolemat Suomen tasolla, joten kuolemadata
on 23.6.2021 alkaen erikoissairaanhoitopiirin tasolla null.
Emme enää päivitä osoitetta https://w3qa5ydb4l.execute-api.eu-west-1.amazonaws.com/prod/finnishCoronaData/v2 kuolemien osalta, sillä muutos vanhaan olisi liian suuri. Kuolematiedot siis jatkossa vain ylläolevasta osoitteesta. Avatkaa issueita jos tämä on ongelma ja niin voidaan pohtia uudestaan.
Rajapinnat palauttavat JSONia.
Havaintodata joka näyttää tältä (formaatti voi vaihtua, mutta pyritään seuraamaan hyviä API-suunnittelun periaatteita eikä poisteta tai muuteta kenttien nimiä). Ajat UTC:ssa.
Sekä uusi että vanha havaintodatarajapinta toteuttavat tämän rajapinnan - sillä erotuksella että uudessa rajapinnassa kuolematiedot ovat sairaanhoidon erityisvastuualueiden mukaan jaoteltu, kuten THL:n datassa. Uudessa rajapinnassa ei myöskään ole saatavilla tietoa tartuntamaista tai tartuntaketjuista - niitä varten kannattaa katsoa vanhaa rajapintaa.
Uudessa rajapinassa id on muotoiltu muotoon <sairaanhoitopiiri>_<havainnon_päivämäärä>_<monesko_havainto_päivässä>.
Syy siihen on se, että THL:n data päivittyy takautuvasti (testien valmistuminen kestää 2-4 päivää), joten juoksevan
numeroinnin käyttö ei käy järkeen. Tämän id:n pitäisi olla vakaa THL:n datojen päivitysten yli.
{
confirmed: [
{
id: <numeerinen id merkkijonomuodossa (kuten "1"), juokseva numerointi, tai kuten yllä kuvattu>,
date: <havainnon aika ISO 8601 -formaatissa>,
healthCareDistrict: <sairaanhoitopiiri. null jos ei tiedossa>,
infectionSource: <tartunnan lähteen id (eli tästä listasta), "unknown" jos ei tiedetä ja "related to earlier" jos tarkkaa lähdettä ei tiedetä mutta tiedetään että liittyy johonkin aiempaan tapaukseen>,
infectionSourceCountry: <jos tiedossa, infection lähdemaa ISO 3166-1 alpha-3 -formaatissa>
},
.
.
.
],
deaths: [
{
id: <numeerinen id merkkijonomuodossa (kuten "1"), juokseva numerointi, tai kuten yllä kuvattu>,
date: <havainnon aika ISO 8601 -formaatissa>,
healthCareDistrict: <sairaanhoitopiiri>,
area: <erityissairaanhoitopiiri uudessa rajapinnassa, vanhas>
},
.
.
.
],
recovered: [
{
id: <numeerinen id merkkijonomuodossa (kuten "1"), juokseva numerointi. ei liity muihin id:ihin>,
date: <havainnon aika ISO 8601 -formaatissa>,
healthCareDistrict: <sairaanhoitopiiri>,
},
.
.
.
]
}
Sairaanhoitopiirien nimet kuten täällä, sillä erotuksella että Helsingin ja Uudenmaan sairaanhoitopiiri on esitetty muodossa HUS.
infectionSource -kenttää voidaan käyttää tartuntaketjujen havainnollistamiseen.
recovered-kentän listaus parantuneista tapauksista on hyvin best effort -tyyppinen tätä kirjoittaessa. Katso lisää keskustelua aiheesta
täältä. Jos haluat kokeilla jonkinlaista kaavaa (esimerkiksi yli kaksi viikkoa
vanhat havainnot oletetaan parantuneiksi), niin voit sen itse tehdä - tarjottuun dataan ei tulla tekemään tällaisia laskelmia, vaan siinä ilmoitetaan
tiedot sellaisina kuin ne on lähteistä saatu ja luotettavaksi arvioitu.
Sairaaladata näyttää tältä (esimerkki):
{
hospitalised: [
{
"date": "2020-03-25T13:00:00.000Z", // Aikaleima (jolloin tieto lisätty)
"area": "HYKS", // Erityisvastuualue, Finland jos koko suomi ja "Other whan HYKS" kun kerran näin oli datassa
"totalHospitalised": 63, // Kokonaismäärä sairaalahoidossa, numero
"inWard": 45, // Osastolla olevat
"inIcu": 18, // Tehohoidossa olevat
"dead": 2 // Kuolleiden määrä
},
.
.
.
]
}
Erityisvastuualueiden nimistä käytetään pelkkiä lyhenteitä kuten täällä.
Tämä data on snapshotteja THL:n julkaisemista kokonaisluvuista, minkä johdosta formaatti on ei ole paras mahdollinen. Seuraamme miten tilanne kehittyy ja parannamme jos parempaa vaihtoehtoa ilmaantuu / keksimme miten / ilmoitustapa vakiintuu.
Prosessoidusta THL-datasta saa parhaan kuvan esimerkkidatasta. value-kenttä kertoo, kuinka monta tartuntatapausta testien perusteella
on havaittu päivänä.
Testidatan esimerkit ovat täällä Suomen aikasarjasta ja täällä viimeisimmästä sairaanhoitopiirin tiedosta.
HS on käyttänyt ja käyttää dataa ainakin näissä grafiikoissa:
(Tee pull request jos haluat omasi tänne.)
Sairaanhoitopiirit kartalla (VuokkoH)
Suomen koronavirus-tartuntatilanne (valstu)
Koronavirus-twitterbotti (Duukkis)
Koronavirus-tilanne maittain (Julleht)
Koronaviruksen tartutukset (kallehj)
Verkkograafi Koronatartuntaketjuista (Miksus)
Aktiiviset tartunnat kartalla (Jonniek)
Koronavirus-Telegrambotti (source) (ultsi)
Koronapaniikki.fi - Koronavirustilanne kartalla maakunnittain (source) (mouhgang)
State of corona in Finland (pauliinasol)
Hoitsubotti - telegram-botti (Karvaporsas)
COVID-19 Finland: Discord & Telegram Bot (jhamberg)
A Map of the Coronavirus disease (COVID-19) outbreak in Finland (Lovell D'souza)
Korona-animaatio (Antti Härkönen)
Finland COVID-19 data (Avicted)
koronakartta.info - Korona suomessa, historiallinen leviäminen (source) (Marantle)
Koronatartunnat Suomessa (source) (Eevis Panula)
Finland Corona Info (source) (Jingzhe Yu)
Covid-19 per 100,000 people (lounjukk)
COVID19 Bot a.k.a Corona-chan - Discord Botti (Tatatofly)
Covid-19 forecaster (Datarion)
Finland Corona Stat updates (source) (Ermias Hailemicheal)
COVID-19 Stats Finland mobile app (secretwpn)
Short term forecasts of Covid-19 cases in Finland
Tämä data on peräisin julkisista lähteistä. HS pyrkii kasaamaan sen mahdollisimman paikkansa pitävänä. Emme takaa, että päivitämme dataa jatkuvasti ja saatamme lopettaa datan päivittämisen ennalta ilmoittamatta, esimerkiksi tartuntatilanteen tai julkisten lähteiden muuttuessa. Saatamme myös muuttaa datarakennetta tai osoitteita ennalta ilmoittamatta.
The old style (HS gathered) latest observation data used by HS can be read from https://w3qa5ydb4l.execute-api.eu-west-1.amazonaws.com/prod/finnishCoronaData
(yes, a direct address to an AWS Lambda API gateway). GET request works. Here you can get the published amount of infected, dead and
recovered by health care district. Reason this is not updated is that THL is publishing their own data, it's reporter differently from the past times
and data collection from the health care districts doesn't work too well anymore since THL is publishing their data and the districts don't anymore (
which makes total sense).
From the endpoint (https://w3qa5ydb4l.execute-api.eu-west-1.amazonaws.com/prod/finnishCoronaHospitalData) you can read the amount of people in hospital care. This data has been scraped of THL reports. Example data here.
For observations, we offer now (https://w3qa5ydb4l.execute-api.eu-west-1.amazonaws.com/prod/finnishCoronaData/v2). It's compatible with the old observations endpoint, but uses the THL data as a source. See example data here. HOX: deaths won't update in this endpoint anymore. See info about the update on 9.7.2021 below.
Update 28.12.2020
In the v2 endpoint above we have now removed the infectionSource and infectionSourceCountry fields. This was done in order to get the
HTTP response to fit the AWS lambda limits. We strongly suggest to migrating to the separate hospital data endpoint above and the processed
THL data below.
Our processed THL data can be read from (https://w3qa5ydb4l.execute-api.eu-west-1.amazonaws.com/prod/processedThlData). Example data here.
Testing related data is offered for Finland level in a timeseries (https://w3qa5ydb4l.execute-api.eu-west-1.amazonaws.com/prod/thlTestData) and the latest information on health carea area level (https://w3qa5ydb4l.execute-api.eu-west-1.amazonaws.com/prod/hcdTestData).
Update 8.1.2021
From (https://w3qa5ydb4l.execute-api.eu-west-1.amazonaws.com/prod/finnishVaccinationData) you can read the latest info on Finnish vaccinations. HS adds new data manually when THL has published new data.
Update 9.7.2021
THL changed their reporting on 23.6.2021 regardin death and hospitalisation data. Until 23.6. the hospitalisation and death data was available in an HTML table (updated daily or weekly) on the THL website which we scraped. When this practice ended the only source for death and hospital data was the official THL API. Given this change the following changes in the interfaces have been made:
The hospital data endpoint (https://w3qa5ydb4l.execute-api.eu-west-1.amazonaws.com/prod/finnishCoronaHospitalData) returns data such
that until 23.6.2021 you'll get the old data unchanged we used to serve, after which the new THL data is appended to the data. This causes
as small discontinuity in the data between 23.6. and 24.6., since THL reports the incidents on the day it happened, whereas our method put
the incidents on the day they were reported. THL only serves death data on Finland level now, so the death data on the lower area level
after 23.6.2021 is null.
The endpoint https://w3qa5ydb4l.execute-api.eu-west-1.amazonaws.com/prod/finnishCoronaData/v2 won't be updated with death data anymore, since the update would be too big. You should use the above endpoint for death data. If this is a major issue, open issues and we might work something out.
The APIs return JSON.
The observation data which is structured as follows (the format may change, but good API development practices will be considered and field names should remain the same and fields shouldn't be removed for example). All times in UTC.
Bot the new and old observation API adhere to the following schema. The difference is that in the new API the deaths are split the special health care areas (as per THL). Additionally, the new API doesn't have the information about source countries or the infection chains. Those can be still read from the old API.
In the new API the id is formatted as <health_care_district>_<date>_<nth_observastion_on_date>. This is due to the
fact that the THL data updates with a delay (since the data there is reported according to the testing date, whereas
the old way was to report when the tests were published and the tests take 2-4 days to update). Sequential number
doesn't make sense here and this schema should be stable accross THL data updates.
{
confirmed: [
{
id: <numeric, sequential id in string format (such as "1"), or as above>,
date: <date when this observation was made, ISO 8601 -format>,
healthCareDistrict: <health care district. null if unknown>,
infectionSource: <id of the infection source (from this array), "unknown" if unknown and "related to earlier" if we cannot pinpoint the exact source but know it's from known exposure>,
infectionSourceCountry: <if known, infection source country in ISO 3166-1 alpha-3 format>
},
.
.
.
],
deaths: [
{
id: <numeric, sequential id in string format (such as "1"), or as above>,
date: <date when this observation was made, ISO 8601 -format>,
healthCareDistrict: <health care district>,
area: <the special health care district in the new API>
},
.
.
.
],
recovered: [
{
id: <numeric, sequential id in string format (such as "1"). not related to other ids>,
date: <date when this observation was made, ISO 8601 -format>,
healthCareDistrict: <health care district>,
},
.
.
.
]
}
The health care distrticts follow naming conventions from here, with the difference that the health care district of Helsinki and Uusimaa is called HUS.
infectionSource field can be used to inspect infection chains.
The list in recovered field is very much a best effort attempt at showing the recovered numbers. The topic has been discussed here. If you want to try out a formula (for example, counting all confirmed
cases that are older than two weeks as recovered) feel free to do so. The data offered here will not be subject to such calculations, but will instead provide information as obtained from the sources considered to be reliable.
The hospitalisation data looks like this (example)
{
hospitalised: [
{
"date": "2020-03-25T13:00:00.000Z", // Timestamp (when the item was added)
"area": "HYKS", // The health care area, Finland if whole Finland and "Other whan HYKS" since a data point like this exists
"totalHospitalised": 63, // Total amount of hospitalised people in the area
"inWard": 45, // In a regular hospital ward
"inIcu": 18, // In intensive care
"dead": 2 // Amount of deaths in the area
},
.
.
.
]
}
The areas are abbreviated like this.
This data is snapshots from THL published reports, which makes the format a little weird. We'll follow how the data format develops and will improve it once we have time / figure out how / the way it's reprted stabilises.
Best idea about the processed THL data is in the example data. value field tells how many infections were found in tests on that date.
Test data examples are here for Finnish timeseries test data and here for the latest health care district test data.
Copyright 2020 Helsingin Sanomat
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.