Table of Contents |
---|
Description
Returns a list all recent observations of notable bird species (along with their most recent sighting and location) in near a given area.
This is part of the eBird version 1.1 API.
URL
Base URL
http://ebird.org/ws1.1/data/notable/geo/recent
Examples
Minimal:
http://ebird.org/ws1.1/data/notable/geo/recent?lng=-76.51&lat=42.46
Fully specified:Example
http://ebird.org/ws1.1/data/notable/geo/recent?lng=-76.50741651&lat=42.4599446&dist=2&back=5&maxResults=500&detail=simple&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="448aa5a5-4357-480f-9e2b-8cda0adf4385"><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="5d7a2d1b-bd8d-45ba-aa77-6342b6c5659c"><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 |
| ]]></ac:plain-text-body></ac:structured-macro> | <ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="ceda8331-4617-4b4d-8a46-b0c03744bf7c"><ac:plain-text-body><![CDATA[, two decimal places of precision required | |||||||||
dist | 250 [ | 0 ,- 250 ] integer | 15 100 | 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="ad93e473-ccff-4e45-89fb-654b2e15b05f"><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="0a3d6343-4889-438e-b0db-c26a6e232f7b"><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 | 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 |
| xml json | json, xml | json | format of the response | |||||||||||
hotspot |
|
Results
General result comments
...
false | true,false | false | set to true if results should be limited to sightings at birding hotspots |
Include Page | ||||
---|---|---|---|---|
|
Wiki Markup |
---|
{import:eBird-footer} |