Table of Contents |
---|
Description
Returns the most recent observations of a species sighting date and specific location for the requested species of bird reported within the number of days specified by the "back" parameter and reported in a given area.
This is part of the eBird version 1.1 API.
URL
Base URL
http://ebird.org/ws1.1/data/obs/geo_spp/recent
...
http://ebird.org/ws1.1/data/obs/geo_spp/recent?lng=-76.51&lat=42.46&sci=branta%20canadensis
Fully specified:
http://ebird.org/ws1.1/data/obs/geo_spp/recent?lng=-76.51&lat=42.46&sci=branta%20canadensis&dist=2&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 |
| 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). This only accepts scientific names of the category "species" and will generate an "unknown species" error for names in any other category. See eBird-1.1-SpeciesReference for a complete list of supported scientific names and a complete list of categories. |
|
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} |