Skip to contents

About

rminka is a wrapper for Minka APIs for accessing the observations.

Installation

The easiest way to get rminka is to install from github repository with pak:

pak::pak("Raiservi/rminka")

Quickstart guide

These functions are designed to be used together. For queries that span multiple years, you can easily loop through the years of interest, run the appropriate function, and then combine the resulting tibbles with dplyr::bind_rows(). > It is recommended to set the quality argument to "research" in order to get more reliable data that has been validated by several contributors.

Project Queries

A set of complementary functions to find projects and their associated observations.

- Project Queries

  • mnk_proj_byname Finds a project’s ID using an approximate project name.
prj_names <- mnk_proj_byname("2025")

prj_names 
#> # A tibble: 10 × 8
#>       id title     place_id slug  created_at updated_at project_type description
#>    <int> <chr>        <int> <chr> <chr>      <chr>      <chr>        <chr>      
#>  1   417 BioMARat…      244 biom… 2025-03-2… 2025-10-3… collection   "La BioMAR…
#>  2   418 BioMARat…      245 biom… 2025-03-2… 2025-08-2… collection   "La BioMAR…
#>  3   419 BioMARat…      249 biom… 2025-03-2… 2025-10-3… collection   "La BioMAR…
#>  4   420 BioMARat…      248 biom… 2025-03-2… 2025-08-2… collection   "La BioMAR…
#>  5   424 BioMARat…      701 biom… 2025-04-0… 2025-12-1… collection   "Descobre …
#>  6   233 Biodiver…       NA biod… 2023-12-0… 2025-04-2… umbrella     "Aquest pr…
#>  7   228 Biodiver…      277 biod… 2023-12-0… 2025-05-0… collection   "Aquest pr…
#>  8   224 Biodiver…      311 biod… 2023-12-0… 2025-05-0… collection   "Aquest pr…
#>  9   415 Biodiver…      247 biod… 2025-03-2… 2025-05-2… collection   "Recull de…
#> 10   524 Exposici…      437 expo… 2025-11-0… 2025-11-1… collection   "Conjunt d…

#In detail:

kable(prj_names[,c(1:5)])
id title place_id slug created_at
417 BioMARató 2025 (Catalunya) 244 biomarato-2025-catalunya 2025-03-25T15:56:46+00:00
418 BioMARató 2025 (Girona) 245 biomarato-2025-girona 2025-03-25T15:58:46+00:00
419 BioMARató 2025 (Tarragona) 249 biomarato-2025-tarragona 2025-03-25T15:59:26+00:00
420 BioMARató 2025 (Barcelona) 248 biomarato-2025-barcelona 2025-03-25T17:00:14+01:00
424 BioMARatona 2025 701 biomaratona-2025 2025-04-04T18:46:30+02:00
233 Biodiverciutat 2025 - Àrea Metropolitana de Barcelona (Repte Naturalista Urbà) NA biodiverciutat-2025-area-metropolitana-de-barcelona-repte-naturalista-urba 2023-12-05T15:55:12+00:00
228 Biodiverciutat 2025 - Castelldefels (Repte Naturalista Urbà) 277 biodiverciutat-2025-castelldefels-repte-naturalista-urba 2023-12-05T15:37:27+00:00
224 Biodiverciutat 2025 - Barcelona (Repte Naturalista Urbà) 311 biodiverciutat-2025-barcelona-repte-naturalista-urba 2023-12-05T10:14:10+00:00
415 Biodiversitat NauticinBlu 2025 247 biodiversitat-nauticinblu-2025 2025-03-20T09:25:07+00:00
524 Exposició de Bolets de la Serralada Litoral 2025 437 exposicio-de-bolets-de-la-serralada-litoral-2025 2025-11-06T15:28:06+00:00
  • mnk_proj_info Retrieves detailed project information using its known ID.

prj_info <- mnk_proj_info(420)

prj_info
#> $id
#> [1] 420
#> 
#> $title
#> [1] "BioMARató 2025 (Barcelona)"
#> 
#> $created_at
#> [1] "2025-03-25T17:00:14+01:00"
#> 
#> $subscrib_users
#> [1] 16
#> 
#> $place_id
#> [1] 248
#> 
#> $slug
#> [1] "biomarato-2025-barcelona"
#> 
#> $description
#> [1] "La BioMARató és un esdeveniment de ciència ciutadana que té l'objectiu de conèixer la biodiversitat del litoral de Catalunya mitjançant una competició amistosa entre les persones participants. En aquest projecte es recullen les observacions marines i costaneres de la província de Barcelona."

kable(as.data.frame(prj_info))
id title created_at subscrib_users place_id slug description
420 BioMARató 2025 (Barcelona) 2025-03-25T17:00:14+01:00 16 248 biomarato-2025-barcelona La BioMARató és un esdeveniment de ciència ciutadana que té l’objectiu de conèixer la biodiversitat del litoral de Catalunya mitjançant una competició amistosa entre les persones participants. En aquest projecte es recullen les observacions marines i costaneres de la província de Barcelona.

It´s posible to known the users subscrived in this projects chnging de parameter ‘user = TRUE’ and the function gives a list of the id users.


prj_info_us <- mnk_proj_info(419, users = TRUE)

prj_info_us
#> # A tibble: 24 × 1
#>    id_users
#>       <int>
#>  1        4
#>  2        6
#>  3       11
#>  4       12
#>  5       13
#>  6       52
#>  7      159
#>  8      166
#>  9      197
#> 10      219
#> # ℹ 14 more rows

kable(t(as.data.frame(prj_info_us)))
id_users 4 6 11 12 13 52 159 166 197 219 817 866 908 988 1081 1178 1659 2437 5214 5965 6023 7061 16772 17299

- mnk_proj_obs

kable(as.data.frame(obs_prj))


**- User Queries ** 
  
* mnk_user_byname 


``` r

user_name <- mnk_user_byname("ramon")

user_name
#> 
[38;5;246m# A tibble: 6 × 5
[39m
#>      id login         name                     observations_count created_at    
#>   
[3m
[38;5;246m<int>
[39m
[23m 
[3m
[38;5;246m<chr>
[39m
[23m         
[3m
[38;5;246m<chr>
[39m
[23m                                 
[3m
[38;5;246m<int>
[39m
[23m 
[3m
[38;5;246m<chr>
[39m
[23m         
#> 
[38;5;250m1
[39m  
[4m5
[24m098 ramon          
[31mNA
[39m                                       0 2024-07-15T09…
#> 
[38;5;250m2
[39m     6 ramonservitje 
[38;5;246m"
[39m
[38;5;246m"
[39m                                     
[4m1
[24m259 2022-04-16T15…
#> 
[38;5;250m3
[39m 
[4m1
[24m
[4m7
[24m845 ramonmares    
[38;5;246m"
[39mRamon de los mares
[38;5;246m"
[39m                     21 2025-12-10T14…
#> 
[38;5;250m4
[39m   615 ramoncedeno    
[31mNA
[39m                                       1 2023-05-16T07…
#> 
[38;5;250m5
[39m  
[4m1
[24m631 ramontog      
[38;5;246m"
[39mRamón Montoya González
[38;5;246m"
[39m                  0 2024-03-09T07…
#> 
[38;5;250m6
[39m  
[4m3
[24m748 ninifan       
[38;5;246m"
[39mRamon Reyes
[38;5;246m"
[39m                             0 2024-06-08T01…

kable(as.data.frame(user_name))
id login name observations_count created_at
5098 ramon NA 0 2024-07-15T09:47:24+00:00
6 ramonservitje 1259 2022-04-16T15:47:14+00:00
17845 ramonmares Ramon de los mares 21 2025-12-10T14:18:19+00:00
615 ramoncedeno NA 1 2023-05-16T07:09:31+00:00
1631 ramontog Ramón Montoya González 0 2024-03-09T07:12:03+00:00
3748 ninifan Ramon Reyes 0 2024-06-08T01:51:51+00:00
  • mnk_user_proj

user_project <- mnk_user_proj(6)

user_project
#> # A tibble: 10 × 7
#>       id title                       description slug  icon  place_id created_at
#>    <int> <chr>                       <chr>       <chr> <chr>    <int> <chr>     
#>  1   338 ANERIS - Biodiversitat Mas… "El projec… aner… http…      436 2024-09-0…
#>  2    44 Anthozoos del Barcelonés    "Estudi de… anth… http…       NA 2022-09-2…
#>  3     9 BioMARató 2022 (Barcelona)  "La BioMAR… biom… http…      248 2022-04-1…
#>  4    20 BioMARató 2022 (Catalunya)  "La BioMAR… biom… http…      244 2022-04-1…
#>  5     1 BioMARató 2022 (Girona)     "La BioMAR… biom… http…      245 2022-04-1…
#>  6    10 BioMARató 2022 (Tarragona)  "La BioMAR… biom… http…      249 2022-04-1…
#>  7   283 BioMARató 2024 (Catalunya)  "La BioMAR… biom… http…      244 2024-03-2…
#>  8   280 BioMARató 2024 (Tarragona)  "La BioMAR… biom… http…      249 2024-03-2…
#>  9   420 BioMARató 2025 (Barcelona)  "La BioMAR… biom… http…      248 2025-03-2…
#> 10   419 BioMARató 2025 (Tarragona)  "La BioMAR… biom… http…      249 2025-03-2…

kable(as.data.frame(user_project))
id title description slug icon place_id created_at
338 ANERIS - Biodiversitat Masia Blanca (Seguiment de Biodiversitat Marina a Comarruga)) El projecte Biodiversitat Masia Blanca és un projecte de ciència ciutadana on la finalitat és recollir totes les observacions de biodiversitat marina de la Reserva Marina de Masia Blanca, a Comarruga.

Seguint amb la línia d’objectius del projecte, es pretén incrementar el valor del patrimoni natural que conté el municipi per mitjà d’accions divulgatives a la ciutadania, visitants i itinerants de la pròpia localitat. Biodiversitat Masia Blanca està encapçalat pel centre Oceanicos, en coordinació amb la Federació Catalana d’Activitats Subaquàtiques (FECDAS), i que es troba dins del projecte europeu ANERIS. Aquest projecte europeu impulsat per Institut de Ciències del Mar (ICM-CSIC) i que pretén fomentar la participació ciutadana com a mitjà per a l’obtenció de dades sobre biodiversitat, creant una xarxa d’observadors/es al llarg del litoral català.

Segueix-nos i participa en el projecte i en totes les seves novetats! |aneris-biodiversitat-masia-blanca-seguiment-de-biodiversitat-marina-a-comarruga |https://minka-sdg.org/attachments/projects/icons/338/span2/LogoRodo-300x300.png?1725261395 | 436|2024-09-02T07:16:36+00:00 | | 44|Anthozoos del Barcelonés |Estudi dels anthozoos del municipi del Barcelonés. |anthozoos-del-barcelones |https://minka-sdg.org/attachments/projects/icons/44/span2/Actinia_bl-1.png?1665227958 | NA|2022-09-28T17:49:39+00:00 | | 9|BioMARató 2022 (Barcelona) |La BioMARató es una manera divertida de competir de forma amistosa con otras provincias de la costa catalana y participar en uno de los mayores acontecimientos del año ciencia ciudadana marina.

En este proyecto se recogen las observaciones de la BioMARató de la provincia de Barcelona |biomarato-2022-barcelona |https://minka-sdg.org/attachments/projects/icons/9/span2/icon.png?1650368280 | 248|2022-04-19T11:38:01+00:00 | | 20|BioMARató 2022 (Catalunya) |La BioMARató es una manera divertida de competir de forma amistosa con otras provincias de la costa catalana y participar en uno de los mayores acontecimientos del año ciencia ciudadana marina. |biomarato-2022-catalunya |https://minka-sdg.org/attachments/projects/icons/20/span2/icon.png?1650378269 | 244|2022-04-19T14:24:30+00:00 | | 1|BioMARató 2022 (Girona) |La BioMARató es una manera divertida de competir de forma amistosa con otras provincias de la costa catalana y participar en uno de los mayores acontecimientos del año ciencia ciudadana marina.

En este proyecto se recogen las observaciones de la BioMARató de la provincia de Girona |biomarato-2022-girona |https://minka-sdg.org/attachments/projects/icons/1/span2/icon.png?1650363077 | 245|2022-04-19T10:11:18+00:00 | | 10|BioMARató 2022 (Tarragona) |La BioMARató es una manera divertida de competir de forma amistosa con otras provincias de la costa catalana y participar en uno de los mayores acontecimientos del año ciencia ciudadana marina.

En este proyecto se recogen las observaciones de la BioMARató de la provincia de Tarragona |biomarato-2022-tarragona |https://minka-sdg.org/attachments/projects/icons/10/span2/icon.png?1650368406 | 249|2022-04-19T11:40:06+00:00 | | 283|BioMARató 2024 (Catalunya) |La BioMARató és un esdeveniment de ciència ciutadana que té l’objectiu de conèixer la biodiversitat del litoral de Catalunya mitjançant una competició amistosa entre les persones participants. En aquest projecte es recullen les observacions marines i costaneres de tota la costa catalana. |biomarato-2024-catalunya |https://minka-sdg.org/attachments/projects/icons/283/span2/logo_biomarato_social.png?1711375059 | 244|2024-03-25T13:52:39+00:00 | | 280|BioMARató 2024 (Tarragona) |La BioMARató és un esdeveniment de ciència ciutadana que té l’objectiu de conèixer la biodiversitat del litoral de Catalunya mitjançant una competició amistosa entre les persones participants. En aquest projecte es recullen les observacions marines i costaneres de la província de Tarragona. |biomarato-2024-tarragona |https://minka-sdg.org/attachments/projects/icons/280/span2/logo_biomarato_social.png?1711374606 | 249|2024-03-25T14:50:06+01:00 | | 420|BioMARató 2025 (Barcelona) |La BioMARató és un esdeveniment de ciència ciutadana que té l’objectiu de conèixer la biodiversitat del litoral de Catalunya mitjançant una competició amistosa entre les persones participants. En aquest projecte es recullen les observacions marines i costaneres de la província de Barcelona. |biomarato-2025-barcelona |https://minka-sdg.org/attachments/projects/icons/420/span2/logo_biomarato_social.png?1742918414 | 248|2025-03-25T17:00:14+01:00 | | 419|BioMARató 2025 (Tarragona) |La BioMARató és un esdeveniment de ciència ciutadana que té l’objectiu de conèixer la biodiversitat del litoral de Catalunya mitjançant una competició amistosa entre les persones participants. En aquest projecte es recullen les observacions marines i costaneres de la província de Tarragona. |biomarato-2025-tarragona |https://minka-sdg.org/attachments/projects/icons/419/span2/logo_biomarato_social.png?1742918365 | 249|2025-03-25T15:59:26+00:00 |