Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Wiki Markup
{toc}
{snipedit}


h2. Description

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

 This is part of the [eBird version 1.1 API|eBird-1.1].

h2. URL

*Base URL*

[
Table of Contents

Description

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

 This is part of the eBird version 1.1 API.

URL

Base URL

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

...

Examples

Minimal:

]\\

*Examples*

Minimal:

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

...

Parameter Descriptions

...

Parameter Name

...

Required

...

Default

...

Value Options

...

Example Value

...

Description

...

lat

...

yes

...

-90.00 - 90.00 decimal

...

42.46

...

decimal latitude, two decimal places of precision required

...

lng

...

yes

...

-180.00 - 180.00 decimal

...

-76.51

...

decimal longitude, two decimal places of precision required

...

dist

...

25

...

0 - 50 integer

...

15

...

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

...

back

...

 

...

14

...

1 - 30 integer

...

7

...

the number of days back to look for observations

...

maxResults

...

 

...

1 - 10000 integer

...

10

...

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

...

detail

...

 

...

simple

...

simple, full

...

simple

...

see result field descriptions  tcl-add a description

...

locale

...

 

...

en_US

...

Java standard locale codes

...

fr_CA

...

]

h2. Parameter Descriptions

|| Parameter Name || Required || Default \\ || Value Options \\ || Example Value \\ || Description ||
| lat | yes \\ | \\ | \-90.00 - 90.00 decimal \\ | 42.46 \\ | decimal latitude, two decimal places of precision required |
| lng | yes \\ | \\ | \-180.00 - 180.00 decimal | \-76.51 | decimal longitude, two decimal places of precision required |
| dist \\ | \\ | 25 | 0 - 50 integer \\ | 15 | distance defining area of interest from given lat/lng in kilometers \\ |
| back \\ | | 14 \\ | 1 - 30 integer | 7 | the number of days back to look for observations \\ |
| maxResults | | \\ | 1 - 10000 integer \\ | 10 \\ | the maximum number of result rows to return in this request; to get all results do not include this parameter \\ |
| detail \\ | | simple \\ | simple, full \\ | simple \\ | see [result field descriptions|eBird-1.1-ObservationsResultDescription]  tcl-add a description \\ |
| 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, xml

...

json

...

format of the response

...

]. \\ |
| fmt \\ | | json \\ | json, xml \\ | json \\ | format of the response \\ |
{include:eBird-1.1-ObservationsResultDescription

...

}