h1. Recent eBird Observations Made Nearby a Location - Version 1.1

{toc}

h2. Description

Returns 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|eBird API 1.1].

h2. URL

*Base URL*

[http://ebird.org/ws1.1/data/obs/geo/recent]\\

*Examples*

Minimal:

[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&locale=en_US&fmt=json]

h2. 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 radius 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 \\ |
| 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 \\ |
| 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 \\ |
| hotspot \\ | | false \\ | true, false \\ | false \\ | set to true if results should be limited to sightings at birding hotspots \\ |
{include:eBird API 1.1-SimpleResultsDescription}
{import:eBird-footer}