Description
Returns a list of all bird species seen within a nearby area, along with their most recent sighting date and specific location.
This is part of the eBird version 1.1 API.
URL
Base URL
http://ebird.org/ws1.1/data/obs/geo/recent
Examples
minimal| http://ebird.org/ws1.1/data/obs/geo/recent?lng=-76.51&lat=42.46
fully specified| http://ebird.org/ws1.1/data/obs/geo/recent?lng=-76.51&lat=42.46&dist=2&back=5&maxResults=500&detail=simple&locale=en_US&fmt=json&includeProvisional=true
xml|http://ebird.org/ws1.1/data/obs/geo/recent?lng=-76.51&lat=42.46&fmt=xml
json|http://ebird.org/ws1.1/data/obs/geo/recent?lng=-76.51&lat=42.46&fmt=json
error (xml)| http://ebird.org/ws1.1/data/obs/geo/recent?lng=-76.51&lat=142.46&fmt=xml
error (json)| http://ebird.org/ws1.1/data/obs/geo/recent?lng=-76.51&lat=142.46&fmt=json
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 |
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 |