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/nearest/geo_spp/recent
Example
http://ebird.org/ws1.1/data/obsnearest/geo_spp/recent?lng=-76.507416&lat=42.45994&hotspot=true&sci=branta%20canadensis
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="66eae7023187a5a7-5a6ea870-4af04f3b-a199b7de-c5140ea85ac589ab5f2cda16"><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="630a6ce35aa0815b-1b462b7d-4de04043-a8179e09-4963cf35550e3065d78bcc7a"><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="777a70f3241f4bd6-b2225519-493e49a5-ba8eae3e-4e1b18fba3fd794e2ec2fe39"><ac:plain-text-body><![CDATA[ | dist | 25 | [0,50] | 15 | distance defining area of interest from given lat/lng in miles kilometers |
| ]]></ac:plain-text-body></ac:structured-macro> | |
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="9a9af099c5fb07f3-531b5d0d-4f8a4d26-94d7afc1-cfa9d06b8d761c75bb456f09"><ac:plain-text-body><![CDATA[ | back db |
| 14 | [1,30] | 7 | daysBack, the number of days since the current date 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="4c7ceddbab7d0321-3c169703-42724bc1-9efc8aa7-c4e07e9e358ee071aca93ba9"><ac:plain-text-body><![CDATA[ | maxResults |
| unlimited n/a | [01,infinity) 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> sci |
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 |
| ||
sci | y |
| any scientific name | larus%20delawarensis | scientific name of the species of interest |
| ||
hotspot |
| false | true,false | false | set to true if results should be limited to sightings at hotspots |
|
Results
General result comments
Format
General format notes.
JSON
Specific format notes.