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="997abdb49bcd8d23-c396e1ec-4b4347ad-b988826a-606488afd100a13a49d55d0e"><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="3342e11e9b971b0e-adf6c245-47bc4a1b-921284b8-8975f6df163ecea1acb15f92"><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="8d790d90a3768279-aeca1f09-4fc44bb2-989dab27-bd8419fb204b09cbf32a490b"><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="595a100dbdf2bfae-fcf1c876-4e774955-a906bb89-4ba9aceea64f226dcf06b014"><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="ac3ac27b7a44f908-3538f2c0-45dd4792-b7318e28-ce7d403fc87a2ba58f15133c"><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.