Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin
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.50741651&lat=42.46&sci=branta%20canadensis

Fully specified:

http://ebird.org/ws1.1/data/nearest/geo_spp/recent?lng=-76.51&lat=42.4599446&sci=branta%20canadensis&hotspot=true&sci=branta%20canadensisImage Removed&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="790d9706-b7ed-4968-8103-b07f9264436a"><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="000dec0f-d150-43c5-b8ff-9452dd99dd6c"><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="d2b9747f-a78d-48e0-9ec6-92280588ad7d"><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="a311176b-922e-4326-a067-1d8f343f3490"><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
true

false

whether set to restrict the results to birding hotspots
 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
eBird API 1.1-SimpleResultsDescription
eBird API 1.1-SimpleResultsDescription
Wiki Markup
{import:eBird-footer}