Wrapper to the eBird API.
R Makefile
Latest commit 46e70d9 Jul 11, 2016 @sebpardo sebpardo committed on GitHub Merge pull request #48 from sebpardo/master
Update ebird_GET return line with @andyteucher's suggestion
Permalink
Failed to load latest commit information.
R Update ebird_GET return line with @andyteucher's suggestion, bump ver… Jul 11, 2016
inst/vign Update vignette with ebirdfreq and ebirdregioncheck, close #11 May 2, 2015
man
tests change nearestobs egs and test for a species that isnt missing Aug 25, 2015
vignettes Remove unused figure and subfolder from vignette dir Jul 1, 2015
.Rbuildignore Remove NEWS.md from .Rbuildignore, add cran-comments variants Mar 23, 2016
.gitignore
.travis.yml
DESCRIPTION Update ebird_GET return line with @andyteucher's suggestion, bump ver… Jul 11, 2016
LICENSE update man pages for new roxyge2n version, bump version, tidy descrip… Feb 7, 2016
Makefile
NAMESPACE Bundle commits before pulling upstream master Mar 22, 2016
NEWS.md Bump to v0.3.0, update NEWS and cran-comments Mar 23, 2016
README.Rmd Use CRAN master URL to avoid canonical URL NOTE Mar 23, 2016
README.md Use CRAN master URL to avoid canonical URL NOTE Mar 23, 2016
appveyor.yml merge with upstream master Mar 22, 2016
cran-comments.md

README.md

reBird

Build Status Build status Coverage Status rstudio mirror downloads cran version

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

Install

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")

Sightings at location determined by latitude/longitude

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)

Recent observations at a region

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)

Recent observations at hotspots

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)

Frequency of observations at hotspots or regions

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
## ..                         ...       ...       ...        ...

Meta


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.


ropensci_footer