| Table of Contents |
|---|
Description
Returns a list of all bird species (along with their the most recent sighting date and location) specific location for the requested species of bird reported within the number of days specified by the "back" parameter and reported in a given area.
This is part of the eBird version 1.1 API.
URL
Base URL
http://ebird.org/ws1.1/data/nearestobs/geo_spp/recent
ExamplesExample
Minimal:
http://ebird.org/ws1.1/data/nearestobs/geo_spp/recent?lng=-76.50741651&lat=42.45994&hotspot=true&sci=branta%20canadensis.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="b0f2187e-d6f9-4fe7-843b-83dc099906cd"><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="4689a5ae-0887-4259-ab87-a739d51340c2"><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="534ddc8b-dbcb-49f4-8c80-38ef9e96ce0d"><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="76f97409-ad35-4015-8102-a33ffb9e36a6"><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="b7006a14-3c4a-4938-88e2-f9b4801d99d7"><ac:plain-text-body><![CDATA[ | maxResults |
| unlimited | [ 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 |
| ||||||||||
sci | yes y |
| any scientific name | larus%20delawarensis | scientific name of the species of interest (not case sensitive). This only accepts scientific names of the category "species" and will generate an "unknown species" error for names in any other category. See eBird-1.1-SpeciesReference for a list of supported scientific names and a complete list of categories. |
| ||||||||||
hotspot |
| false | true,false | false | set to true if results should be limited to sightings at hotspots |
| ||||||||||
includeProvisional |
|
Results
General result comments
Format
General format notes.
JSON
Specific format notes.
...
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 |
| Include Page | ||||
|---|---|---|---|---|
|
| Wiki Markup |
|---|
{import:eBird-footer} |