Description
Returns a list of all bird species (along with their most recent sighting and location) in a given area.
Base URL
http://ebird.org/ws1.1/data/obs/geo/recent
Example
http://ebird.org/ws1.1/data/obs/geo/recent?lng=-76.507416&lat=42.45994
Parameter Descriptions
parameter |
required |
default |
value options |
example value |
description |
status |
||
---|---|---|---|---|---|---|---|---|
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="07c2af09-8dde-43cd-a158-501e674abb35"><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="a0ab57ad-d6f5-45db-aa15-7146c0c00676"><ac:plain-text-body><![CDATA[ |
lng |
y |
n/a |
[-180,180] |
-76.51 |
decimal longitude |
|
]]></ac:plain-text-body></ac:structured-macro> |
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="faf1736d-e7ee-49f9-adea-e625de35c582"><ac:plain-text-body><![CDATA[ |
dist |
|
25 |
[0,50] |
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="b8634a3d-6460-4772-a4dd-5a269a078375"><ac:plain-text-body><![CDATA[ |
back |
|
14 |
[1,30] |
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="64429cac-2504-44f3-bdaf-4a699e0d49ae"><ac:plain-text-body><![CDATA[ |
maxResults |
|
unlimited |
[1,10000] |
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 |
|
|||
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 |
json |
format of the response |
|
Results
General result comments
Format
General format notes.
JSON
[{"howMany":"39","lat":42.4791969,"locID":"L97555","locName":"Sapsucker Woods","commonName":"Mallard","lng":-76.4513778,"scientificName":"Anas platyrhynchos","obsDt":"Mar 2, 2009"},{"howMany":"8","lat":42.4791969,"locID":"L97555","locName":"Sapsucker Woods","commonName":"Mourning Dove","lng":-76.4513778,"scientificName":"Zenaida macroura","obsDt":"Mar 2, 2009"}]