R Client for the eBird Database of Bird Observations

A programmatic client for the eBird database, including functions for searching for bird observations by geographic location (latitude, longitude), eBird hotspots, location identifiers, by notable sightings, by region, and by taxonomic name.


reBird is a package to interface with the eBird webservices.

eBird is a real-time, online bird checklist program. For more information, visit their website: http://www.ebird.org

the API for the eBird webservices can be accessed here: https://confluence.cornell.edu/display/CLOISAPI/eBird+API+1.1

You can install the stable version from CRAN

install.packages("rebird")

Or the development version from Github

install.packages("devtools")
devtools::install_github("ropensci/rebird")

Then load the package

library("rebird")

Search for bird occurrences by latitude and longitude point

ebirdgeo(species = 'spinus tristis', lat = 42, lng = -76)
## Source: local data frame [22 x 11]
## 
##               obsDt       lng
##               (chr)     (dbl)
## 1  2016-03-22 15:50 -76.03871
## 2  2016-03-22 09:35 -76.00722
## 3  2016-03-21 08:10 -75.89760
## 4  2016-03-20 11:00 -75.89836
## 5  2016-03-20 08:00 -75.85645
## 6  2016-03-20 07:30 -75.96821
## 7  2016-03-20 07:00 -76.01614
## 8  2016-03-19 16:45 -76.03404
## 9  2016-03-19 10:52 -75.98304
## 10 2016-03-19 10:50 -75.91689
## ..              ...       ...
## Variables not shown: locName (chr), obsValid (lgl), comName (chr),
##   obsReviewed (lgl), sciName (chr), locationPrivate (lgl), howMany (int),
##   lat (dbl), locID (chr)

Search for bird occurrences by region and species name

ebirdregion(region = 'US', species = 'Setophaga caerulescens')
## Source: local data frame [12 x 11]
## 
##               obsDt       lng                                      locName
##               (chr)     (dbl)                                        (chr)
## 1  2016-03-21 12:15 -81.36384           US-Florida-Lake Mary-Extended Stay
## 2  2016-03-20 11:29 -80.31086                            A. D. Barnes Park
## 3  2016-03-20 11:00 -81.54980                               Crooked Holler
## 4  2016-03-20 09:53 -81.84061                     Dave  and  Tammy's House
## 5  2016-03-19 17:20 -80.14181 Richardson Historic Park and Nature Preserve
## 6  2016-03-19 10:00 -80.34860                              Cutler Wetlands
## 7  2016-03-19 07:45 -80.44960                       Castellow Hammock Park
## 8  2016-03-17 08:15 -80.17166                      Topeekeegee Yugnee Park
## 9  2016-03-16 13:41 -80.82018                                  Long Key SP
## 10 2016-03-12 09:48 -80.39846                                    Zoo Miami
## 11 2016-03-11 11:36 -80.41000                 John Pennekamp Coral Reef SP
## 12 2016-03-11 09:00 -80.15430                               Greynolds Park
## Variables not shown: obsValid (lgl), comName (chr), obsReviewed (lgl),
##   sciName (chr), locationPrivate (lgl), howMany (int), lat (dbl), locID
##   (chr)

Search for bird occurrences by region

ebirdhotspot(locID = c('L99381','L99382'))
## Source: local data frame [99 x 11]
## 
##               obsDt       lng      locName obsValid           comName
##               (chr)     (dbl)        (chr)    (lgl)             (chr)
## 1  2016-03-23 08:23 -76.50375 Stewart Park     TRUE        Snow Goose
## 2  2016-03-23 08:23 -76.50375 Stewart Park     TRUE      Canada Goose
## 3  2016-03-23 08:23 -76.50375 Stewart Park     TRUE         Wood Duck
## 4  2016-03-23 08:23 -76.50375 Stewart Park     TRUE           Mallard
## 5  2016-03-23 08:23 -76.50375 Stewart Park     TRUE      Lesser Scaup
## 6  2016-03-23 08:23 -76.50375 Stewart Park     TRUE  Hooded Merganser
## 7  2016-03-23 08:23 -76.50375 Stewart Park     TRUE  Common Merganser
## 8  2016-03-23 08:23 -76.50375 Stewart Park     TRUE        Ruddy Duck
## 9  2016-03-23 08:23 -76.50375 Stewart Park     TRUE Pied-billed Grebe
## 10 2016-03-23 08:23 -76.50375 Stewart Park     TRUE      Horned Grebe
## ..              ...       ...          ...      ...               ...
## Variables not shown: obsReviewed (lgl), sciName (chr), locationPrivate
##   (lgl), howMany (int), lat (dbl), locID (chr)

Obtain historical frequencies of bird occurrences by hotspot or region

ebirdfreq(loctype = 'hotspots', loc = 'L196159')
## Source: local data frame [8,304 x 4]
## 
##                        comName   monthQt frequency sampleSize
##                          (chr)     (chr)     (dbl)      (dbl)
## 1  Greater White-fronted Goose January-1 0.0000000         22
## 2                   Snow Goose January-1 0.0000000         22
## 3               Cackling Goose January-1 0.0000000         22
## 4                 Canada Goose January-1 0.0000000         22
## 5        Cackling/Canada Goose January-1 0.0000000         22
## 6               Trumpeter Swan January-1 0.0000000         22
## 7                    Wood Duck January-1 0.1818182         22
## 8                      Gadwall January-1 0.0000000         22
## 9              Eurasian Wigeon January-1 0.4090909         22
## 10             American Wigeon January-1 1.0000000         22
## ..                         ...       ...       ...        ...

This package is part of a richer suite called spocc - Species Occurrence Data, along with several other packages, that provide access to occurrence records from multiple databases. We recommend using spocc as the primary R interface to rebird unless your needs are limited to this single source.


News

rebird 0.3.0

  • Fix for httr::content after changes in httr v1.0.0 (#38).

rebird 0.2

  • Added two new functions ebirdfreq and ebirdregioncheck, which provide historical frequency of observation data and check whether a region is valid under eBird, respectively.
  • Passed along curl options to httr functions
  • Replaced RJSONIO with jsonlite
  • Replaced plyr with dplyr

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.

install.packages("rebird")

0.4.0 by Sebastian Pardo, 5 months ago


http://github.com/ropensci/rebird


Report a bug at http://github.com/ropensci/rebird/issues


Browse source code at https://github.com/cran/rebird


Authors: Rafael Maia [aut], Scott Chamberlain [aut], Andy Teucher [aut], Sebastian Pardo [aut, cre]


Documentation:   PDF Manual  


Task views:


MIT + file LICENSE license


Imports methods, utils, stats, httr, jsonlite, dplyr

Suggests knitr, testthat, covr


Imported by spocc.


See at CRAN