Recent eBird Observations Made Nearby a Location - Version 1.1
| Table of Contents |
|---|
Description
Returns a list of all bird species seen within a nearby area, along with their the most recent sighting date and specific location for each species of bird reported within the number of days specified by the "back" parameter and reported in the specified area.
This is part of the eBird version 1.1 API.
URL
Base URL
http://ebird.org/ws1.1/data/obs/geo/recent
Examples
BasicMinimal:
http://ebird.org/ws1.1/data/obs/geo/recent?lng=-76.51&lat=42.46
Fully specified:
http://ebird.org/ws1.1/data/obs/geo/recent?lng=-76.51&lat=42.46&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="1a64082d-f465-46cc-bcbb-9c0005e64c81"><ac:plain-text-body><![CDATA[ | lat | y | n/a | [-90,90] | 42.46 | decimal latitude, no more than two decimal places of precision to facilitate caching | ]]></ac:plain-text-body></ac:structured-macro> | <ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="a7e55f4d-ccc4-4745-b9f5-207f4fe6ec20"><ac:plain-text-body><![CDATA[ | lng | y | n/a | required | |
lng | yes | -180.00 - 180.00 decimal [-180,180] | -76.51 | decimal longitude, no more than two decimal places of precision to facilitate caching required | ||||||||||||
| ]]></ac:plain-text-body></ac:structured-macro> | <ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="d49ad190-1923-48a4-9346-57295b0bba6b"><ac:plain-text-body><![CDATA[ | dist | 25 | [ 0 ,- 50 ] integer | 15 | distance defining area radius 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="8545557c-2e56-477a-b8dc-73a2631ee42d"><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="e51f091b-c0eb-49c2-b399-d7d3dc80112f"><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 |
| |||
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 | |||||||||||
includeProvisional |
|
Results and Error Conditions
See the page on Result Field Descriptions for Raw Data Services
...
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 | ||
hotspot |
| false | true, false | false | set to true if results should be limited to sightings at birding hotspots |
| Include Page | ||||
|---|---|---|---|---|
|
| Wiki Markup |
|---|
{import:eBird-footer} |
...