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:
Parameter Descriptions
Parameter Name |
Required |
Default |
Value Options |
Example Value |
Description |
|
---|---|---|---|---|---|---|
lat |
yes |
|
-90.00 - 90.00 decimal |
42.46 |
decimal latitude, two decimal places of precision required |
|
lng |
yes |
|
-180.00 - 180.00 decimal |
-76.51 |
decimal longitude, two decimal places of precision required |
|
dist |
|
25 |
0 - 50 integer |
15 |
distance defining area of interest from given lat/lng in kilometers |
|
back |
|
14 |
1 - 30 integer |
7 |
the number of days back to look for observations |
|
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 |
|
detail |
|
simple |
simple |
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, 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 |
true,false |
false |
set to true if results should be limited to sightings at 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 |