Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Returns a list of all bird species (along with their most recent sighting and location) in a given area.

Base URL

 http://ebird.org/ws1.1/data/nearestobs/geo_spp/recent

Example

http://ebird.org/ws1.1/data/nearestobs/geo_spp/recent?lng=-76.507416&lat=42.45994&hotspot=true&sci=branta%20canadensis

Parameter Descriptions

parameter

required

default

value options

example value

description

status

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="1bbc9b970edbb6b7-115b2fc4-40704e8d-9daf9de9-ff6fbbc9448df5ecac6f6891"><ac:plain-text-body><![CDATA[

lat

y

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="f7d72cd7d28630ec-845ef6d9-47f74668-9946be7e-7eca78a72799d1dad48a8e89"><ac:plain-text-body><![CDATA[

lng

y

n/a

[-180,180]

-76.51

decimal longitude

 

]]></ac:plain-text-body></ac:structured-macro>

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="aefe3ef7d022c8ca-18c4f1df-49df4894-8ac0a66d-50bf947a0d6fe49a453e14eb"><ac:plain-text-body><![CDATA[

dist


25

[0,50]

15

distance defining area of interest from given lat/lng in kilometers

 

]]></ac:plain-text-body></ac:structured-macro>

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="e3994487215fae68-360c3271-40e947c8-92ebb230-4948c733e36f65bc63afc730"><ac:plain-text-body><![CDATA[

back

 

14

[1,30]

7

the number of days back to look for observations

 

]]></ac:plain-text-body></ac:structured-macro>

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="3379f7ee7eb7a76c-c9eda0dc-455d4a91-b3c8a598-b7b885037b75294a53712317"><ac:plain-text-body><![CDATA[

maxResults

 

unlimited

[1,10000]

10

the maximum number of result rows to return in this request; to get all results do not include this parameter

 

]]></ac:plain-text-body></ac:structured-macro>

detail

 

simple

simple, full

simple


 

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

 

json

json

json

format of the response

 

sci

y

 

any scientific name

larus%20delawarensis

scientific name of the species of interest

 

hotspot

 

false

true,false

false

set to true if results should be limited to sightings at hotspots

 

...