Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

Description

Returns a list of all bird species (along with their most recent sighting and location) the most recent observations of a species 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

ExamplesExample

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/recent?lng=-76.51&lat=42.46&sci=branta%20canadensis&dist=2&back=5&maxResults=500&detail=simple&locale=en_US&fmt=json

Parameter Descriptions

parameter Parameter Name

required Required

Default default

value options

example value

description

status

Value Options

Example Value

Description

lat

yes


-90.00 - 90.00 decimal

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="610a4013-e480-4b88-aca2-d795f6701f29"><ac:plain-text-body><![CDATA[

lat

y

n/a

[-90,90]

42.46

decimal latitude

]]></ac:plain-text-body></ac:structured-macro>

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="a83f61ce-958b-4d0c-ac42-f91827eaa1bb"><ac:plain-text-body><![CDATA[

lng

y

n/a

, two decimal places of precision required

lng

yes


-180.00 - 180.00 decimal [-180,180]

-76.51

decimal longitude, two decimal places of precision required

 

]]></ac:plain-text-body></ac:structured-macro>

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="ddee9a44-b763-4823-81d6-91207da460a4"><ac:plain-text-body><![CDATA[

dist


25

[ 0 ,- 50 ] integer

15

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

 

]]></ac:plain-text-body></ac:structured-macro>

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="bdebd60e-b5cb-4c46-afac-11e474b54cba"><ac:plain-text-body><![CDATA[

back

 

14

[ 1 ,- 30 ] integer

7

the number of days back to look for observations

 

]]></ac:plain-text-body></ac:structured-macro>

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="c8d576a0-eab5-4c4f-9a8d-d3bcd38940e0"><ac:plain-text-body><![CDATA[

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
 

]]></ac:plain-text-body></ac:structured-macro>

detail

 

simple

simple, full

simple

toggle to restrict results to either all or a subset of sighting fields.  see result field descriptions 

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

 

json

json, xml

json

format of the response
 

sci

yes y

 

any scientific name

larus%20delawarensis

scientific name of the species of interest (not case sensitive).  See the eBird taxonomy for a complete list of supported scientific names

 

hotspot

 

false

true,false

false

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

 

Results and Error Conditions

...

Include Page
CLOISAPI:eBird-1.1-ObservationsResultDescription
CLOISAPI:eBird-1.1-ObservationsResultDescription