Repository files navigation

rgbif is an R package which gives you access toGBIF mediated data via itsREST API.

GBIF (the Global Biodiversity Information Facility) is an international network and data infrastructure funded by the world's governments and aimed at providing anyone, anywhere, open access to data about all types of life on Earth.

install.packages("rgbif")# CRAN version

pak::pkg_install("ropensci/rgbif")# dev version

install.packages("rgbif",repos="https://dev.ropensci.org")# dev version

There are several long-form articles that can help get you started:

• Getting Started
• Getting Occurrence Data From GBIF
• Working With Taxonomic Names

Most GBIF users are interested in getting lat-lon occurrence records.

occ_search(scientificName="Pan troglodytes")occ_data(scientificName="Pan troglodytes")

It is usually better to get occurrence records using ataxonKey. See the articleWorking With Taxonomic Names.

taxonKey<- name_backbone("Pan troglodytes")$usageKeyocc_search(taxonKey=taxonKey)

GBIFstrongly recommends the use ofocc_download() rather thanocc_search() for serious research projects. See articleGetting Occurrence Data From GBIF.

It is required to set up yourGBIF credentials to make downloads from GBIF.

occ_download(pred("taxonKey",5219534))# 5219534 is the taxonKey for Pan troglodytes

Under the terms of the GBIF data user agreement, users who download data agree to cite a DOI. Please see GBIF’scitation guidelines andCiting GBIF Mediated Data.

Please also citergbif by runningcitation(package = "rgbif").

This list honors all contributors in alphabetical order. Code contributors are in bold.

adamdsmith -AgustinCamacho -AldoCompagnoni -AlexPeap -andzandz11 -AshleyWoods -AugustT -barthoekstra -benmarwick -cathynewman -cboettig -coyotree -damianooldoni -dandaman -djokester -dlebauer -dmcglinn -dmi3kno -dnoesgaard -DupontCai -ecology-data-science -EDiLD -elgabbas -emhart -fxi -ghost -gkburada -hadley -Huasheng12306 -ibartomeus -JanLauGe -jarioksa -jeroen -jhnwllr -jhpoelen -jivelasquezt -jkmccarthy -johnbaums -jtgiermakowski -jwhalennds -karthik -kgturner -Kim1801 -ljuliusson -ljvillanueva -luisDVA -martinpfannkuchen -MattBlissett -MattOates -maxhenschell -mdsumner -no-la-ngo -Octoberweather -omahs -Pakillo -peterdesmet -PhillRob -PietrH -poldham -qgroom -raymondben -rossmounce -sacrevert -sagitaninta -sckott -scottsfarley93 -simon-tarr -SriramRamesh -stevenpbachman -stevensotelo -stevenysw -TomaszSuchan -tphilippi -vandit15 -vervis -vijaybarve -willgearty -Xuletajr -yvanlebras -zixuan75

• Pleasereport any issues or bugs.
• License: MIT
• Get citation information forrgbif in R doingcitation(package = 'rgbif')
• Please note that this package is released with aContributor Code of Conduct. By contributing to this project, you agree to abide by its terms.

There are similar GBIF clients in other languages :

• Python
• Ruby
• PHP

This package is part ofspocc, along with several other packages, that provide access to occurrence records from multiple data sources.