Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin
Table of Contents

Description

Returns the most recent sighting date and specific location for the requested species of bird reported within the number of days specified by the "back" parameter and reported in a given area.

 This is part of the eBird version 1.1 API.

URL

Base URL

http://ebird.org/ws1.1/data/obs/geo_spp/recent

Examples

Minimal:

http://ebird.org/ws1.1/data/obs/geo_spp/recent?lng=-76.51&lat=42.46&sci=branta%20canadensis

Fully specified:

http://ebird.org/ws1.1/data/obs/geo_spp/recent?lng=-76.51&lat=42.46&sci=branta%20canadensis&dist=2&back=5&maxResults=500&locale=en_US&fmt=json&includeProvisional=true

Parameter Descriptions

Parameter Name

Required

Default

Value Options

Example Value

Description

lat

yes


-90.00 - 90.00 decimal

42.46

decimal latitude, two decimal places of precision required

lng

yes


-180.00 - 180.00 decimal

-76.51

decimal longitude, two decimal places of precision required

dist


25

0 - 50 integer

15

distance defining area of interest from given lat/lng in kilometers

back

 

14

1 - 30 integer

7

the number of days back to look for observations

maxResults

 


1 - 10000 integer

10

the maximum number of result rows to return in this request; to get all results do not include this parameter

locale

 

en_US

Java standard locale codes

fr_CA

Language/locale of response (when translations are available). See http://java.sun.com/javase/6/docs/api/java/util/Locale.html.

fmt

 

xml

json, xml

json

format of the response

sci

yes

 

any scientific name

larus%20delawarensis

scientific name of the species of interest (not case sensitive).  This only accepts scientific names of the category "species" and will generate an "unknown species" error for names in any other category.  See eBird-1.1-SpeciesReference for a list of supported scientific names and a complete list of categories.

 

hotspot

 

false

true,false

false

set to true if results should be limited to sightings at hotspots

 

includeProvisional

 

false

true,false

false

set to true if you'd like flagged records that have not yet been reviewed to be included in the results

Include Page
eBird API 1.1-SimpleResultsDescription
eBird API 1.1-SimpleResultsDescription
Wiki Markup
{import:eBird-footer}