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

Compare with Current View Page History

« Previous Version 4 Next »

Description

Returns the nearest N locations (specified with the maxResults parameter) with observations of a species.  Result is not necessarily in sorted order.

Base URL

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

Example

http://ebird.org/ws1.1/data/nearest/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="6addb4f8-9eb7-4e9c-91a7-cb1c1c8b6507"><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="4ba533b2-3495-4d59-801f-59cafe8f4feb"><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="2c94732c-1141-40d6-98e4-3991eb8de490"><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="32207be1-bfe8-4e94-b9f5-e40131a4a1bc"><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="42e0dc4f-7d84-48f8-b296-6e4a48e045b0"><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

true

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

 

Results

General result comments

Format

General format notes.

JSON

Specific format notes.

Special Conditions & Error Handling

  • No labels