Helsinki Region Infosharen (hri.fi) järjestämän koulutuksen materiaalit. Sisältö: Mitä on avoin data? Avoimen datan hyödyntämisesimerkkejä Mikä on Helsinki Region Infoshare? Datan avaamisen perusteet käytännössä Ryhmätehtävä Mikä on ohjelmointirajapinta?

1. H E L S I N K I • E S P O O • V A N T A A • K A U N I A I N E N
hri.fi
Datan avaamisen perusteet
4.10.2021 | KOULUTUS
Hami Kekkonen ja Kaisa Voipio
Helsingin kaupunginkanslia

2. Koulutuksen ohjelma
Klo 13.00 Esittelykierros: tutustutaan osallistujiin
Mitä on avoin data?
Hyödyntämisesimerkkejä
Mikä on Helsinki Region Infoshare?
Avaamisen perusteet käytännössä
Pienryhmäkeskustelu huoneissa
Klo 14.25 10 min tauko
Klo 14.35 Mikä on ohjelmointirajapinta?
Klo 14.50 Datan avaaminen Helsingin kaupungissa / Ville Jussila, Helsingin
kaupunki
Klo 15.10 Paikkatiedon hyödyntäminen / Antti Ahola, Geosprint Oy
Klo 15.40 Loppukeskustelu
Klo 16.00 Koulutus päättyy

3. Esittelykierros
Mitä sinulle tulee mieleen termistä avoin data?
Mitä toivot koulutukselta?
Onko sinulla jo nyt joitakin kysymyksiä?

4. Avoin data

5. Mitä data on?

6. Valtavasti dataa
Sosiaali- ja
terveydenhuolto
Energia
Maankäyttö
Rakentaminen
Päätökset
Väestö
Päivähoito ja
koulutus
Julkinen liikenne
Tapahtumat
Kulttuuri
Pysäköinti
Asuminen

7. Avoin data pähkinänkuoressa
Julkista tietoa
Lupa käyttää
Maksutta saatavilla
Rakenteisessa muodossa

8. Julkista tietoa, mutta ei avointa dataa
Liikenneonnettomuudet Helsingissä 2014-2016 -julkaisu (pdf)

9. Julkisesta tiedosta avoimeksi dataksi
Liikenneonnettomuudet Helsingissä -aineisto HRI:ssa

10. Avoimen datan hyötyjä
JULKISHALLINTO
Hallinnon sisäinen
tehokkuus
KUNTALAINEN
Läpinäkyvyys ja
demokratia
YRITYKSET
Liiketoiminta ja
innovaatiot
KORKEAKOULUT
Opetus ja tutkimus

11. Avoimen datan hyödyntäminen

12. Lukuisia mahdollisuuksia
Liiketoiminta Osallistuminen Datajournalismi
Opetus ja tutkimus Läpinäkyvyys Taide

13. Läpinäkyvyyttä
visualisoinneilla
Vantaan, Kauniaisten,
Espoon ja Helsingin
kaupunkien ostot
Handata-sovellus

14. Paikkatietovisualisointeja Twitterissä
Topi Tjukanovin tekemiä pieniä paikkatietovisualisointeja:
• pääkaupunkiseudun rakennusten ikä
• Helsingin kasvu vuosien saatossa
• matka-aikoja
Pääkaupunkiseudun rakennusten ikä
Helsingin kasvu
Topi Tjukanovin Twitter-tili

15. Kurkistus
menneisyyteen ja
muutokseen
Helsingin ortoilmakuvat eri
vuosikymmeniltä
Helsinki ilmakuvina 1932 alkaen-
sovellus
Ilmakuvia myös Espoosta,
Kauniaisista ja Vantaalta HRI:ssä
ja kaupunkien karttapalveluissa

16. Datojen yhdistely luovasti
Helsinki 1943 3D -sovellus

17. Vertaile historiaa ja nykyhetkeä
Helsinki ennen ja nyt -sovellus

18. Sovelluksilla uutta liiketoimintaa ja
innovaatioita
HSL:n avoin data
Helsinki Public Transport Visualized
ReittiGPS
Blindsquare
Nysse

19. Uusia palveluja nopeasti
HSL:n Reittiopas API -data
Tellinkibotti-sovellus

20. Paikat, tapahtumat ja aktiviteetit
MyHelsinki Open API -data

21. Tutkimusmateriaalia
HY:n Quantitative methods for sustainable land use planning
I: Accessibility & mobility analyses -kurssin lopputöitä

22. Sovellusgalleria
• HRI:n sovellusgalleria
• Ulkopuolisten tahojen tekemien,
avointa dataa hyödyntävien
sovellusten, visualisointien ja
ohjeistuksien esittelyä
• Sovellusideoiden kerääminen
käyttäjiltä

23. Helsinki Region Infoshare

24. Pääkaupunkiseutu – avoimen datan
edelläkävijä
Helsinki Region Infoshare on Suomen monipuolisin avoimen datan palvelu ja kansainvälistä
kärkeä.
Perustettu 2011
Helsingin, Espoon, Vantaan ja Kauniaisten kaupunkien yhteinen avoimen datan palvelu.
Palvelusta löytyy pääkaupunkiseudun kaupunkeja ja koko seutua koskevaa tietoa
kaikkien vapaasti ja maksutta hyödynnettäväksi.
HRI auttaa kaupunkitiedon avaajia ja tukee tiedon hyödyntäjiä.

25. Strategisia tavoitteita
• ”Helsingin toimintamalli perustuu
mahdollisimman suureen avoimuuteen ja
läpinäkyvyyteen.”
• ”Helsingin tavoitteena on olla maailman
parhaiten digitalisaatiota hyödyntävä kaupunki
maailmassa.”
• ”Helsinki on maailman johtava kaupunki
julkisen tiedon avaamisessa ja sen
hyödyntämisessä.”
• ”Helsingin tuottama data on maailman
käytettävintä ja käytetyintä kaupunkidataa
vuoteen 2025 mennessä.”
• ”Jotta strategian tavoitteet voidaan saavuttaa,
on datan liikuttava kitkattomasti eri
tietojärjestelmien välillä. Data on saatava ulos
järjestelmistä rakenteisessa ja koneluettavassa
muodossa.”
Helsingin kaupunkistrategia 2017-2021
Helsingin datastrategia
Helsingin kaupungin API-linjaukset

26. HRI käytännössä
• Autamme pääkaupunkiseudun
kaupunkeja mm.:
• Avattavien datojen tunnistamisessa
• Datan julkaisukelpoisuuden
arvioimisessa
• Teknisissä ja juridisissa kysymyksissä
• Datan avaamisessa
• Avaamisesta viestimisessä
• Yhteydenpidossa datan hyödyntäjiin
Sähköpostitse / puhelimitse /
palavereissa / infotilaisuuksissa /
koulutuksissa /
kehittäjätapaamisissa…

27. Helsinki Region Infoshare – hri.fi
Datakatalogi
Sovellusgalleria
Uutisia
Blogikirjoituksia
Ohjeistuksia
Viestintämateriaaleja
Viestintää
Koulutuksia
Konsultaatiota
Kehittäjätapaamisia
Korkeakoulu-
yhteistyötä
Hackathoneja

28. Dataa kaikilta elämän aloilta
ASUMINEN
70
HALLINTO JA
PÄÄTÖKSENTEKO
45
KARTAT
165
KULTTUURI JA
VAPAA-AIKA
74
LIIKENNE JA
MATKAILU
92
VÄESTÖ
151
OPETUS JA
KOULUTUS
40
RAKENNETTU
YMPÄRISTÖ
122
TALOUS JA
VEROTUS
42
TERVEYS JA
SOSIAALIPALVELUT
29
TYÖ JA
ELINKEINOT
69
YMPÄRISTÖ
JA LUONTO
79
Datojen lukumäärät syyskuulta 2021

29. Datan metatiedot HRI:ssa
Nimi
Lisenssi
Käyttötilastoja
Lisätietoja
Datasta tehtyjä
sovelluksia
Sanallinen kuvaus
Datan latauslinkki /
linkki rajapintaan
Mahdollisuus kysyä,
keskustella, antaa
palautetta

30. Tervetuloa!
HRI Loves Developers
TAPAHTUMAT SYKSYLLÄ 2021
23.9. Ilmastonmuutokseen
sopeutuminen
11.11. HRI 10 vuotta -juhlawebinaari
2.12. Väestö-teema (tarkempi
otsikko julkaistaan myöhemmin)
Helsinki Loves Developers -ryhmä Facebookissa & Kehittäjäyhteistyöstä HRI:ssa

31. Korkeakouluyhteistyötä
Artikkeli vuoden 2019 opiskelijayhteistyöstä

32. Yhteistyötä
moneen suuntaan
• Suomen suurimmat kaupungit
• Valtion avoimen datan palvelu avoindata.fi & VM
• Kansainvälistä mielenkiintoa (esittelyjä)
• Kansainvälinen yhteistyö
• Mitä tehdään?
• Edistetään yhteneväisiä data-avauksia
• Luodaan avoimia ja standardoituja ohjelmointirajapintoja
• Edesautetaan datojen löydettävyyttä ja hyödyntämistä
• Jatkokehitetään yhdessä avoimen datan portaaleja

33. Avaamisen perusteet käytännössä

34. Datan avaaminen käytännössä

35. Julkisuus ja maksuttomuus
Tiedon oltava julkista
• Julkisuuslaki (Laki viranomaisten toiminnan julkisuudesta)
• Muu lainsäädäntö mm. EU:n tietosuoja-asetus, yleinen turvallisuus
Tieto ei saa sisältää henkilötietoja
• Julkaistaan vain tietoa, jossa ei ole henkilötietoja
• Tarvittaessa tiedon anonymisointi
Julkaisijalla on oikeus julkaista tieto
• Tekijän- ym. Immateriaalioikeudet
• Sopimukset ym.
Maksuttomuus
• Valtuusto päättää palveluista ja muista suoritteista perittävien maksujen
yleisistä perusteista (Kuntalaki 410/2015, 14 § )

36. Lisenssi
• Datan omistaja antaa käyttöoikeuden eli lisenssin datansa:
• Kopiointiin, levitykseen, muokkaukseen, yhdistelyyn ym. sekä ei-
kaupallisessa että kaupallisessa käytössä
• Datan käyttäjä kantaa vastuun sovelluksestaan
• Lisenssisuositus (JHS 189): Creative Commons BY 4.0
• Suositeltava lähdeviittaus sovelluksessa:
Lähde: MyHelsinki Open API – paikat, tapahtumat ja
aktiviteetit. Aineiston ylläpitäjä on Helsinki Marketing. Aineisto on
ladattu Helsinki Region Infoshare -palvelusta 4.5.2021
lisenssillä Creative Commons Attribution 4.0.

37. Koneluettavuus eli rakenteisuus
Ihminen hahmottaa datasta nopeasti esim. otsikot, väli- tai loppusummat, lisätiedot, jne.
Koneelliseen tulkintaan tarvitaan rakenteinen, systemaattinen muoto.

38. Missä muodossa avata dataa?
Tiedostona
• Tiedosto, jossa data ylläpidetään
(xlsx / csv / shp / …)
• Otetaan tieto manuaalisesti ulos
järjestelmästä
• Otetaan tieto automatisoidusti ulos
järjestelmästä
Rajapinnan kautta
• Tehdään ohjelmointirajapinta
(Application Programming
Interface, API) järjestelmästä
automatisoidusti ulos otettavaan
tietoon
• Tehdään järjestelmään / sen
kopioon ohjelmointirajapinta

39. Kysymyksiä, joita on hyvä pohtia
• Kuinka usein data päivittyy / päivitetään?
• Kuinka suuri datamäärä on?
• Onko data reaaliaikaista vai esim. vuosittaista tietoa?
• Kuinka paljon käsityötä datan muokkaaminen vaatii?
• Mihin dataa voisi käyttää?
• Onko standardeja?
• Onko jokin muu taho jo avannut vastaavan datan? Miten se on
tehty? Olisiko data mahdollista avata vastaavassa muodossa?

40. Datan julkaiseminen
• Metatiedot kuntoon
• Sanallinen kuvaus: mitä data pitää sisällään, miten se on tehty, mitä
käyttäjän tulee huomioida ja tietää siitä
• Aineiston jakelualusta:
• Viraston oma palvelin / HRI:n datastore / kaupungin verkkojulkaisujärjestelmä
• Julkaisu
• HRI auttaa joka askeleella!

41. Jatkotoimenpiteet
• Avauksesta tiedottaminen
• Kenelle ja missä avaamisesta on hyvä tiedottaa?
• Datan ylläpito
• Muutoksista tiedottaminen
• Datan / metadatan muutokset
• Palautteen kerääminen ja keskustelu
• Seuraa, millaisen vastaanoton data saa, kerää palautetta, keskustele!
• Järjestä kehittäjätapaaminen tai hackathon yhteistyössä HRI:n kanssa
• Datan päivittäminen
• Päivitä dataan uusimmat tiedot ilmoitetun päivitystiheyden mukaisesti esim. kerran
vuodessa. Päivitysrutiinit on hyvä sopia ja vastuuttaa jo dataa avattaessa.

42. Datan avaamisen oppaita
• HRI:n Opas datan avaamiseen, Datan avaajan pikaopas ja Ohje kyselydatojen
avaamiseen
• Kansallisen avoimen datan portaalin Avoindata.fi:n Datan avaajan opas
• Espoon kaupungin Datan tietosuoja ja tietoturvallinen avaaminen -opas

43. Mallia muualta Suomesta / maailmalta
Lista avoimen datan portaaleista

44. Videoita avoimesta
datasta
• Esittelyvideo HRI:sta ja
avoimesta datasta
• Video avoimista rajapinnoista
• Opetusvideoita paikkatiedon
hyödyntämisestä HRI:n Youtube-
kanavalla

45. Ryhmätehtävä

46. Mitä hyötyä avoimesta
datasta olisi sinulle?
• Mitä dataa tuotat työssäsi?
• Voisiko tätä dataa avata?
• Mitä dataa käytät työssäsi?
• Mitä dataa tarvitsisit työssäsi?
• Millainen sovellus auttaisi sinua
työssä tai arjessa?

47. H E L S I N K I • E S P O O • V A N T A A • K A U N I A I N E N
hri.fi
Tauon paikka!
Koulutus jatkuu klo 14:35

48. Mikä on ohjelmointirajapinta?

49. Avoin rajapinta (avoin API) -video
https://www.youtube.com/watch?v=456Wb2uLSP4

50. Mikä on API?
Ohjelmointirajapinta (engl. application programming interface, API)
on määritelmä, jonka mukaan eri ohjelmat voivat tehdä pyyntöjä ja vaihtaa tietoja
eli keskustella keskenään.
https://fi.wikipedia.org/wiki/Ohjelmointirajapinta

51. API kioskin luukkuna
Tietojärjestelmä Dokumentaatio
Rajapinta

52. Pääkaupunkiseudun palvelukartta rakentuu
rajapinnoille
Avoin rajapinta
Avoimen datan
hyödyntäminen
Avoin
lähdekoodi
Api-lähtöinen
arkkitehtuuri
Pääkaupunkiseudun palvelukartta Pääkaupunkiseudun palvelukartan rajapinnat HRI:ssä

53. Datarajapinta vs. toiminnallinen API
Rajapinnat voi jakaa kahteen ryhmään:
• Datarajapinnat, vain tarjoilevat dataa pyynnöstä
o OpenAhjo (http://dev.hel.fi/apis/openahjo, http://dev.hel.fi/paatokset)
o Palvelukartan toimipisterajapinta (http://www.hel.fi/palvelukarttaws/rest/index_en.html,
http://dev.hel.fi/servicemap)
• Toiminnalliset rajapinnat, joiden läpi voi tallentaa järjestelmään tietoja
o Palautejärjestelmän rajapinta (Open311) (http://dev.hel.fi/apis/issuereporting)
o Tapahtumarajapinta (Linked events) (http://dev.hel.fi/apis/linkedevents)
o Helsingin aukiolorajapinta (Hauki) (kehitteillä)

54. API-lähtöinen- vs. monoliittiarkkitehtuuri
Monoliittinen arkkitehtuuri, jossa komponentit tiukasti yhteenliitetty (“tight coupling”)
● muutokset kalliita ja vaikeita tehdä
● yleensä se yksi käyttöliittymä ja siihen on tyytyminen
● toimittajariippuvuuden vaara suuri
API-lähtöinen arkkitehtuuri, jossa komponentit liitetty toisiinsa rajapintojen avulla (“loose coupling”)
● muutokset komponentteihin vaivattomampia tehdä
● komponenttien vaihtaminen kokonaan mahdollista
● komponenttien kehityksen hajautus eri toimittajille mahdollista

55. Avointen rajapintojen edut tiedostoihin
verrattuna
● Rajapinnasta saatava tieto on aina ajan tasalla
● Rajapinnasta saatavaa tietoa ei kenenkään tarvitse päivittää käsin, vaan
rajapinnassa näkyvät suoraan alkuperäisestä tietolähteestä ne tiedot, jotka
halutaan nähtäville
● Rajapinnassa voidaan esittää hyvin monimutkaista ja monimuotoista dataa
● Rajapinta voidaan tehdä aivan millaiseksi tahansa sen mukaan, mikä on
käyttäjälle ja datalle sopivinta
● Rajapinnasta käyttäjä voi pyytää vain sen datan, mitä tarvitsee

56. APIen käyttö vaatii osaamista: miten
mahdollistaa niiden käyttö myös muille?
• Datasette-työkalu, jonka avulla
käyttäjä voi tarkastella
Palvelukartan avointa APIa
selaimessa taulukkomuodossa
ja ladata sisällön CSV-
tiedostona
• HRI:n sivuille on koottu
tietopaketti teettämäämme
työkaluun liittyen

57. H E L S I N K I • E S P O O • V A N T A A • K A U N I A I N E N
hri.fi
Kiitos!
PROJEKTIPÄÄLLIKKÖ
Hami Kekkonen | 040-334 4780
hami.kekkonen@hel.fi
SUUNNITTELIJA
Kaisa Voipio | 040-358 0647
kaisa.voipio@hel.fi
hri@hel.fi