You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 14 Next »

Description

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/obs/geo/recent

Example

http://ebird.org/ws1.1/data/obs/geo/recent?lng=-76.507416&lat=42.45994

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="cb283691-4edd-4a31-a4e8-9be48caed75c"><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="4f759b3c-7bd0-4768-a681-3ab5ad6f2884"><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="8e4e9747-fbe4-48f0-9aad-645f196dc4c0"><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="5f8feb20-d83c-414f-8a44-54c39a0aa60f"><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="b9a1ba4d-1474-446b-8dfb-a2a761620d8e"><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

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

 

json

json

json

format of the response

 


Results

General result comments

Format

General format notes.

JSON
[{"howMany":"39","lat":42.4791969,"locID":"L97555","locName":"Sapsucker
Woods","commonName":"Mallard","lng":-76.4513778,"scientificName":"Anas
platyrhynchos","obsDt":"Mar 2,
2009"},{"howMany":"8","lat":42.4791969,"locID":"L97555","locName":"Sapsucker
Woods","commonName":"Mourning
Dove","lng":-76.4513778,"scientificName":"Zenaida
macroura","obsDt":"Mar 2, 2009"}]

Special Conditions & Error Handling

  • No labels