Recent eBird Observations Made Nearby a Location - Version 1.1
| Table of Contents |
|---|
Description
Returns a list of all bird species (along with their the most recent sighting date and location) in a given area.
...
specific location for each species of bird reported within the number of days specified by the "back" parameter and reported in the specified area.
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:Example
http://ebird.org/ws1.1/data/obs/geo/recent?lng=-76.50741651&lat=42.4599446&dist=2&back=5&maxResults=500&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="62afec0e-9f6f-4bcd-a197-35a5540d1017"><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="c102fe42-3f63-46d2-a9fb-9f09f52da22b"><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="43435e94-a649-4117-8724-4ae193f4f77e"><ac:plain-text-body><![CDATA[ | dist | 25 | [ 0 ,- 50 ] integer | 15 | distance defining area radius 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="0b2567ff-94c4-44c4-a1f0-d4e296fc4fd7"><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="0fd959f6-7410-422e-9c19-6e81b7dcb920"><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 | | |||
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 | json, xml | json | format of the response | |||||||||||
includeProvisional |
|
Special Conditions & Error Handling
If there are validation problems with the input parameters the response will be an HTTP 400 error code that includes details of the specific problems encountered. Examples for supported input formats are given below:
- JSON
- A simple array containing details of the problems encountered
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 | ||
hotspot |
| false | true, false | false | set to true if results should be limited to sightings at birding hotspots |
| Include Page | ||||
|---|---|---|---|---|
|
| Wiki Markup |
|---|
{import:eBird-footer} |
| No Format |
["Latitude out of range","Longitude out of range"]
|