Table of Contents |
---|
Description
Returns the nearest N locations (specified with the maxResults parameter) with observations of a species.
This is part of the eBird version 1.1 API.
URL
Base URL
http://ebird.org/ws1.1/data/nearest/geo_spp/recent
Examples
Minimal:
http://ebird.org/ws1.1/data/nearest/geo_spp/recent?lng=-76.51&lat=42.46&sci=branta%20canadensis
Fully specified:
http://ebird.org/ws1.1/data/nearest/geo_spp/recent?lng=-76.50741651&lat=42.4599446&sci=branta%20canadensis&hotspot=true&sci=branta%20canadensis\\&back=5&maxResults=500&locale=en_US&fmt=json&includeProvisional=true
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="78b57429-e88c-468f-806d-2387ea1fb7e7"><ac:plain-text-body><![CDATA[ | lat | 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="c466c09e-7794-4535-b9aa-32def23baf76"><ac:plain-text-body><![CDATA[ | lng | 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 | ||||||||||
back |
| ]]></ac:plain-text-body></ac:structured-macro> | <ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="ce7373b0-e58a-464d-a0fb-9e925e344c55"><ac:plain-text-body><![CDATA[ | db |
| 14 | [ 1 ,- 30 ] integer | 7 | daysBack, the number of days since the current date back to look for observations | |||||
maxResults |
| ]]></ac:plain-text-body></ac:structured-macro> | 1000 | 1 - 1000 integer | <ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="ca2cdfcd-c1e6-437b-84f5-ba3071b59ef2"><ac:plain-text-body><![CDATA[ | maxResults |
| n/a | [0,infinity) | 10 | the maximum number of result rows to return in this request | |||
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, xml | json | format of the response | |||||||||
sci | yes |
| any scientific name | larus%20delawarensis | scientific name of the species of interest (not case sensitive). See eBird-1.1-SpeciesReference for a complete list of supported scientific names |
| ||||||||
hotspot |
| false | ]]></ac:plain-text-body></ac:structured-macro> | hotspot | y | | true,false | false | whether set to restrict the results to birding hotspots |
| ||||
includeProvisional |
| 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} |