Table of Contents |
---|
Description
Returns a list of all bird species (along with their most recent sighting and location) the most recent observations of a species in a given area.
This is part of the eBird version 1.1 API.
URL
Base URL
http://ebird.org/ws1.1/data/obs/geo_spp/recent
ExamplesExample
Minimal:
http://ebird.org/ws1.1/data/obs/geo_spp/recent?lng=-76.51&lat=42.46&sci=branta%20canadensis
Fully specified:
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="d458d8f3-9a48-40b8-b206-1e49c04da3d5"><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="14bde96a-2728-4850-b8b1-238b5b203b6b"><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="bdbcd7c5-0d64-443a-8405-6ac0269005cf"><ac:plain-text-body><![CDATA[ | dist | 25 | [ 0 ,- 50 ] integer | 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="004f8b84-464d-4765-85d2-bee0efcbad46"><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="5bed5566-5bac-4df9-9df7-112c635f7276"><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 | toggle to restrict results to either all or a subset of sighting fields. see result field descriptions | |||||||||||
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, xml | json | format of the response | |||||||||||
sci | yes y |
| any scientific name | larus%20delawarensis | scientific name of the species of interest (not case sensitive). See the eBird taxonomy for a complete list of supported scientific names |
| ||||||||||
hotspot |
| false | true,false | false | set to true if results should be limited to sightings at hotspots |
|
Results and Error Conditions
...
Include Page | ||||
---|---|---|---|---|
|