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

Compare with Current View Page History

« Previous Version 24 Next »

Description

Returns a list of all bird species seen within a nearby area, along with their most recent sighting date and specific location.

Base URL

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

Example

Basic:

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&detail=simple&locale=en_US&fmt=json

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="4dde0c72-e773-45d9-bbe0-7f71e2fee359"><ac:plain-text-body><![CDATA[

lat

y

n/a

[-90,90]

42.46

decimal latitude, no more than two decimal places of precision to facilitate caching


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

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="bf73eda6-1833-407a-aca9-8dec6671f3ee"><ac:plain-text-body><![CDATA[

lng

y

n/a

[-180,180]

-76.51

decimal longitude, no more than two decimal places of precision to facilitate caching

 

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

<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="63f8aef6-d6f5-4f77-b1b6-adda78e1b7ab"><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="cc1b7556-7925-46da-8529-3bb155f89518"><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="6e30452d-e2b7-486e-80d5-360ec5972a19"><ac:plain-text-body><![CDATA[

maxResults

 


[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 and Error Conditions

See the page on Result Field Descriptions for Raw Data Services

  • No labels