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. Dataa päivitetään sitä mukaa kun uusia tietoja tulee.
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 tarunnoilta sekä arvioida tartunnan riskejä perustuisivat mahdollismman tarkkaan aineistoon.
Suora rajapinta HS:n dataan (see in English below)
Viimeisimmän HS:n 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.
Rajapinta palauttaa JSONia, joka näyttää tältä (formaatti voi vaihtua, mutta pyritään seuraamaan hyviä API-suunnittelun periaatteita eikä poisteta tai muuteta kenttien nimiä). Esimerkkidataa myös täällä.
{
confirmed: [
{
id: <numeerinen id, juokseva numerointi>,
date: <havainnon aika ISO 8601 -formaatissa>,
healthCareDistrict: <sairaanhoitopiiri>,
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, juokseva numerointi>,
date: <havainnon aika ISO 8601 -formaatissa>,
healthCareDistrict: <sairaanhoitopiiri>,
},
.
.
.
],
recovered: [
{
id: <numeerinen id, juokseva numerointi. ei liity muihin id:eihin>,
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.
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)
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 latest data used by HS can be read from https://w3qa5ydb4l.execute-api.eu-west-1.amazonaws.com/prod/finnishCoronaData
(yes, a direct adress to a AWS Lambda API gateway). GET request works.
The API returns JSON, 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). Example data here.
{
confirmed: [
{
id: <numeric, sequential id>,
date: <date when this observation was made, ISO 8601 -format>,
healthCareDistrict: <health care district>,
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>,
date: <date when this observation was made, ISO 8601 -format>,
healthCareDistrict: <health care district>,
},
.
.
.
],
recovered: [
{
id: <numeric, sequential id. not realted 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 recoverd field is very much a best effort attempt at showing the recovered numbers. The topic has been disussed [here]
(HS-Datadesk#12). If you want to try out a formnula (for example, all confirmed cases
that are older than two weeks are counted as recovered) feel free to do so. The data we offer here will not have formulas or
calculations such as that implemented, we'll simply report the data as given by our
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.