An R programming language interface to the FinBIF (Finnish Biodiversity Information Facility) API (api.laji.fi). FinBIF aggregates Finnish biodiversity data from multiple sources in a single open access portal for researchers, citizen scientists, industry and government. FinBIF allows users of biodiversity information to find, access, combine and visualise data on Finnish plants, animals and microorganisms. The finbif R package makes the publicly available data in FinBIF accessible from within R. Biodiversity information is available on taxonomy and taxon occurrence. Occurrence data can be filtered by taxon, time, location and other variables. The data accessed are conveniently preformatted for subsequent analyses.

Installation

You can install the development version of finbif from GitHub,

remotes::install_github("luomus/finbif")

Documentation

Read the online documentation here.

Getting a FinBIF access token

First load the finbif R package.

library(finbif)

To use the FinBIF API you must first request and set a personal access token. You can request an API token to be sent to your email address with the function finbif_get_token.

finbif_request_token("your@email.com")

Copy the access token that was sent to your email and set it as the environment variable FINBIF_ACCESS_TOKEN either for the current session,

, or by adding it to a Renviron startup file (see here for details).

Usage

Download occurrence data from finbif.

finbif_occurrence("Cygnus cygnus", n = 100)

Contributing

Development is a community effort, and we encourage participation. Please read the contribution guide for details.

Please note that the ‘finbif’ project is released with a Contributor Code of Conduct. By contributing to this project, you agree to abide by its terms.