Exempel på användning

Data publiceras som en datamängd på avoindata.fi. En datamängd innehåller alltid data i csv-format och metadata i json-format. Data kan användas manuellt till exempel som Excel-filer eller maskinellt med hjälp av olika programmeringsspråk.

Manuell användning

Både data och metadata kan laddas ner genom att klicka på länken Ladda ner som finns på datamängdens förstasida. Data kan till exempel laddas ner i Excel. Data är separerat med kommatecken och har teckenkodningen UTF-8.

Maskinell användning

Öppna data är maskinläsbara. Tjänsten Avoindata.fi erbjuder olika alternativ för läsning.

I följande exempel söks uppgifter om det arbetsmarknadsstöd som delfinansieras av kommunerna (avoindata.fi).

Direkt maskinläsning av filer

Med funktionerna i R:s bibliotek ckanr (cran.r-project.org) och i Pythons bibliotek ckanapi (pypi.org) kan man direkt läsa data på avoindata.fi.

Exempel på R:

library(ckanr)
library(readr)
library(jsonlite)

# CKAN definieras
ckanr_setup(url = "https://avoindata.fi/data/fi/")

# Alla FPA:s datamängder söks
x <- package_search(q = "Kela (Kansaneläkelaitos)")

# Resurser från det första datamaterialet plockas
resources <- x$results[[1]]$resources

# Data laddas
dat <- read_csv(resources[[1]]$url)

# Metadata laddas
meta <- fromJSON(txt = resources[[2]]$url)

Läsa data från gränssnittet DataStore med SQL-sökning

I R:s bibliotek ckanr (cran.r-project.org) finns också funktionen för förfrågningar i DataStore-gränssnittet. Med Python måste man göra förfrågan med biblioteket urllib (docs.python.org).

Exempel på R:

library(ckanr)
library(glue)

# CKAN definieras
ckanr_setup(url = "https://avoindata.fi/data/fi/")

# Rätt datamängd söks, datamängden vars rubrik slutar på ordet 'kunnittain' (kommun)
x <- package_search(q = "Kela (Kansaneläkelaitos)", fq = "title:kunnittain$")

# Hämtar id för datamängden
ID <- x$results[[1]]$resources[[1]]$id

# Söker summor och mottagare av de arbetsmarknadsstöd som betalats ut för alla månader i kommunen Helsingfors
res <- ckanr::ds_search_sql(
   sql = glue("
      SELECT
         kunta_nimi,
         vuosikuukausi,
         sum(maksettu_eur) as sum_maksettu_eur,
         sum(saaja_lkm) as sum_saaja_lkm
      FROM \"{ID}\"
      WHERE kunta_nimi = 'Helsinki'
         AND aikatyyppi = 'Kuukausi'
         AND tyomarkkinatukipaiva_luokka = 'Yhteensä'
      GROUP BY vuosikuukausi, kunta_nimi"),
   as = "table")
res$records

# motsvarar rapporten http://raportit.kela.fi/linkki/45699380