Package index • geofi

Statistics Finland API functions

Functions for using Statistics Finland WFS and OGC API features services

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.

ogc_get_statfi_area(): Retrieve Finnish Administrative Area Polygons

ogc_get_statfi_area_pop(): Retrieve Finnish Administrative Area Polygons with Population Data

ogc_get_statfi_statistical_grid(): Retrieve Finnish Statistical Grid with Population Data

National Land Survey API functions

Functions for using National Land survey OGC API features services

municipality_central_localities(): Get up-to-date municipality central locations

ogc_get_maastotietokanta_collections(): Fetch Maastotietokanta Collections

ogc_get_maastotietokanta(): Download a Collection from the Maastotietokanta (Topographic Database)

ogc_get_nimisto(): Query Geographic Names (Nimistö) from the National Land Survey of Finland

geocode(): Geocode Finnish Place Names or Street Addresses

geocode_reverse(): Reverse Geocode Geographic Locations into Finnish Place Names or Addresses

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_key: Aggregated municipality key table for years 2013-2025

municipality_key_2025: Municipality key table for 2025

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

municipality_central_localities_df: A data frame containing locations of municipalities central localities

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 Statistics Finland Geoserver APIs

wfs_api(): WFS API

to_sf(): Transform a wfs_api object into a sf object.