Skip to contents

API calling functions

Functions for fetching spatial data from Statistics Finland WFS-api

get_municipalities()
Get Finnish municipality (multi)polygons for different years and/or scales.
get_zipcodes()
Get Finnish zip code (multi)polygons for different years.
get_population_grid()
Get Finnish Population grid in two different resolutions for years 2010-2022 Thin wrapper around Finnish population grid data provided by Statistics Finland.
get_statistical_grid()
Get Statistical grid data polygons at two different resolution
get_municipality_pop()
Get Number of population by Finnish municipality (multi)polygons for different years.

Data

geofi comes with a timeseries of built-in municipality keys that can be used to aggregate municipality level data (municipality_key_*) and municipality_central_localities data containing point locations for cental locality of each municipality

municipality_central_localities
A simple feature point data containing locations of municipalities central localities
municipality_key
Aggregated municipality key table for years 2013-2024
municipality_key_2024
Municipality key table for 2024
municipality_key_2023
Municipality key table for 2023
municipality_key_2022
Municipality key table for 2022
municipality_key_2021
Municipality key table for 2021
municipality_key_2020
Municipality key table for 2020
municipality_key_2019
Municipality key table for 2019
municipality_key_2018
Municipality key table for 2018
municipality_key_2017
municipality_key_2017
municipality_key_2016
municipality_key_2016
municipality_key_2015
municipality_key_2015
municipality_key_2014
municipality_key_2014
municipality_key_2013
municipality_key_2013

Geofacet grids

geofi comes with a selection of built-in grids to used with geofacet-packages, a ggplot2 extension. All grids are based on the latest municipality breakdown

grid_ahvenanmaa
custom geofacet grid for Ahvenanmaa region
grid_etela_karjala
custom geofacet grid for Etelä-Karjala region as in 2020
grid_etela_pohjanmaa
custom geofacet grid for Etelä-Pohjanmaa
grid_etela_savo
custom geofacet grid for Etelä-Savo
grid_hyvinvointialue
custom geofacet grid for Wellbeing services counties
grid_kainuu
custom geofacet grid for Kainuu region
grid_kanta_hame
custom geofacet grid for Kanta-Häme region
grid_keski_pohjanmaa
custom geofacet grid for Keski-Pohjanmaa region
grid_keski_suomi
custom geofacet grid for Keski-Suomi region as in 2020
grid_kymenlaakso
custom geofacet grid for Kymenlaakso region
grid_lappi
custom geofacet grid for Lappi region as in 2020
grid_maakunta
custom geofacet grid for regions
grid_paijat_hame
custom geofacet grid for Päijät-Häme region
grid_pirkanmaa
custom geofacet grid for Pirkanmaa region
grid_pohjanmaa
custom geofacet grid for Pohjanmaa region
grid_pohjois_karjala
custom geofacet grid for Pohjois-Karjala region
grid_pohjois_pohjanmaa
custom geofacet grid for Pohjois-Pohjanmaa region
grid_pohjois_savo
custom geofacet grid for Pohjois-Savo region
grid_sairaanhoitop
custom geofacet grid for health care districts
grid_satakunta
custom geofacet grid for Satakunta region
grid_uusimaa
custom geofacet grid for Uusimaa region
grid_varsinais_suomi
custom geofacet grid for Varsinais-Suomi region

Attribute data

geofi comes with a three statistical datasets that are used in vignettes

sotkadata_population
Municipality level population data from Sotkanet
sotkadata_swedish_speaking_pop
Municipality level Swedish speaking population numbers from Sotkanet
statfi_zipcode_population
Zipcode level population data from Statistics Finland

Miscellaneous

Support functions for API functions and spatial data transformations

convert_municipality_key_codes()
Convert regional codes in on-board municipality key data sets into variable length characters
check_api_access()
Check access to http://geo.stat.fi/geoserver/wfs
wfs_api()
WFS API
to_sf()
Transform a wfs_api object into a sf object.