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
...
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.51&lat=42.46&sci=branta%20canadensis&hotspot=truedist=2true&back=5&maxResults=500&detail=simple&locale=en_US&fmt=json&includeProvisional=true
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 |
| 1000 | 1 - 10000 1000 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 |
Include Page | ||||
---|---|---|---|---|
|
Wiki Markup |
---|
{import:eBird-footer} |