NEW FEATURES

installation_search() and collection_search() allow you to search for GRSciColl institutions and collections. (#554)

BUG FIXES

Fixed "Error in the HTTP2 framing layer" bug by setting curlopts = list(http_version=2) as the default for most functions. (#805)

MINOR IMPROVEMENTS

The GBIF occurrence search API now actively discourages the use of bulk downloads via paging through occurrence records using occ_search() or related functions. When a user has exceeded a certain threshold of requests, they will be temporarily paused for 5 seconds. A message will be printed to the console when this happens. Users are strongly encouraged to use occ_download() for bulk downloads. (#804)

NEW FEATURES

occ_download_doi() accepts a GBIF download DOI and returns the download key. (#743)
occ_download() now supports download via institutionKey. (#785)

BUG FIXES

Fixed double import bug in occ_download_import(). (#765)
Fixed URL encoding bug in name_backbone_checklist(). (#784)

DOCUMENTATION

Several small improvements to the docs. (#777) (#776) (#773) (#763) (#758)

NEW FEATURES

• New function occ_download_sql() for downloading occurrence data using SQL queries. (#752)

BUG FIXES

• occ_download_cached() bug fixed. (#748)

DOCUMENTATION

• New article GBIF SQL Downloads

NEW FEATURES

• Added many missing occ_search() terms. (#698)
• New function occ_download_describe() for getting information about download formats. (#721)

MINOR IMPROVEMENTS

• Added constituentKey to name_lookup(). (#729)
• Added support for gbifId downloads (#711)

BUG FIXES

• check_inputs()bug fixed. (#706)

DOCUMENTATION

• New article Effectively using occ_search
• Guidance for reversing WKT winding order. (#724)

DEPRECATED

• gbif_citation() datasetKey methods no longer supported (#716)
• "axe" feature in occ_data() is no longer supported. (#718)
• occ_data() is soft deprecated and supported for legacy reasons only, and will no longer add new features.

NEW FEATURES

There have been many additions for accessing dataset metadata.

• dataset_export() downloads all of the results of a dataset_search().

• New functions for getting dataset metadata from a datasetkey (uuid) : dataset_get(), dataset_process(), dataset_networks(), dataset_constituents(), dataset_comment(), dataset_contact(), dataset_endpoint(),
  dataset_identifier(), dataset_machinetag(), dataset_tag(), dataset_metrics().

• New function for getting more obscure dataset metadata, such as machineTags: dataset().

• New functions for listing dataset metadata : dataset_noendpoint(), dataset_duplicate().

• dataset_doi() gets dataset metadata from the dataset's doi.

MINOR IMPROVEMENTS

• Error message improvements for occ_count(). (#686)

Documentation

• New article Getting Dataset Metadata From GBIF

DEPRECATED

• There are no longer static data files in rgbif. This data is better fetched fresh from the appropriate endpoints. (#690) (#688)

• datasets() is soft deprecated, since the interface was overloaded and confusing. See functional replacements above.

• rgbif has a new logo. (#679)

NEW FEATURES

• map_fetch() now returns a base map as a magick::magick-image. This allows for the creation of high quality images from the GBIF maps API. (#675)
• occ_download() terms added to key lookup. (#661) (#589)
• pred_default() is an occ_download() pred function that allows users to easily filter out commonly unwanted occurrence records. (#611)

MINOR IMPROVEMENTS

• Stream error fixed ("HTTP/2 stream 15 was not closed cleanly before end of the underlying stream"). Now map_fetch(), occ_data(), occ_search(), and occ_download_wait() have curlopts = list(http_version=2), which fixes the error. This might need to be the default setting for the whole package. (#656)

• name_suggest() now gives a warning at prevents setting the limit > 100, since this is the GBIF API max. (#657)

Documentation

New article Creating maps from occurrences, which explains how to use map_fetch().

DEPRECATED

• occ_issues() is now deprecated, since it is difficult to maintain, and not widely used. (#651)

MINOR IMPROVEMENTS

• Fixes test that was causing errors on CRAN.

BREAKING CHANGE

• occ_count() parameter type is now deprecated and will no longer work correctly. Please see occ_count_country(), occ_count_pub_country(), occ_count_year(), occ_count_basis_of_record() for replacements. (#622)

DEPRECATED

• occ_count() parameters georeferenced, type, date, to, from are no longer supported and not guaranteed to work correctly. (#622)
• occ_facet() and count_facet() are now deprecated use occ_count(facet="x") instead.

NEW FEATURES

• lit_search() now supports searching the GBIF literature API. (#591)
• occ_count() now supports almost all occ_search() queries. (#622)
• occ_count() now supports the facets interface through occ_count(facet="x"). (#622)
• organizations() (aka publishers) now supports the use of getting lists of publishers by country. (#606)
• occ_download() and occ_search() now support downloading and getting occurrences a certain distance from known country/area centroids via the parameter distanceFromCentroidInMeters. (#594)

MINOR IMPROVEMENTS

• occ_search() now supports more multi-valued parameters. (#617)
• Removed dependencies on randgeo and conditionz. (#624) (#625)

Documentation

New article explaining occ_count() changes and new features Getting Occurrence Counts From GBIF.

NEW FEATURES

• name_backbone_checklist() now accepts strict=TRUE, meaning that only non-fuzzy matches are returned. (#565)
• name_backbone_checklist() now accepts default values for high taxonomy, such as kingdom, phylum, family, ect. (#515)
• name_backbone_checklist() now returns a column is_alternative when verbose=TRUE, which lets the user know if a name was originally considered to be an alternative choice by the name matcher. (#515)

DOCUMENTATION

• Updated README to be more inviting to new users (#574)
• Added data quality section to article Getting Occurrence Data From GBIF. (#575)

MINOR IMPROVEMENTS

• removed sp and rgeos dependencies. (#578)

NEW FEATURES

• name_usage now has the ability to fetch iucn red list categories using data="iucnRedListCategory". (#547)

DOCUMENTATION

• name_backbone_checklist updated definition of verbose argument. (#564)
• "Too many choices" warning added to article Working With Taxonomic Names. (#536)

BUG FIXES

• dataset_gridded bug fixed when inputing only one non-gridded dataset. (#546)

MINOR IMPROVEMENTS

• New CRAN checks badge URL. (#555)
• Updated min vcr requirment to (>= 1.2.0). (#559)
• Updated r-lib actions to v2 (#566)