Versions Compared

Old Version 1

changes.mady.by.user Paul Allen

Saved on

compared with

New Version 2

changes.mady.by.user Paul Allen

Saved on

Key

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

...

URL

description

status

notes

http://ebird.org/data/ebird/bylocnotable/recent?locIDs=L97555,L259855subnational1Code=US-PA&subnational1Code=US-NY[Image Added

]

returns notable sightings for the given state(s)

deployed

 

http://ebird.org/data/ebird/notable/recent?countryCode=US&countryCode=CAImage Added

returns notable sightings for the given country(ies Return summary of recent sightings at the given locID(s)

deployed

 

Parameter Descriptions

parameter

required

default

value options

example value

description

status

locIDs

subnational1Code

either subnational1Code or countryCode is required yes

n/a

comma-separated list of up to three locIDs

L97555,L259855

The data summary is computed using data submitted to the given locIDs (up to three).
If you ask for more than three locIDs the "extras" are silently ignored. The locIDs are made cannonical before the query is run. That is, they are ordered alphabetically, then truncated to at most 3 IDs. If the locIDs given to the system are not already in cannonical form, they are made cannonical and the request is rebsubmitted through a redirect. This is so that we will be able to use the same cache entry for locIDs=L101,L102,L203 no matter what order they are originally submitted.
Note that the query string ?locIDs=L100&locIDs=L101 does not conform to the API and will not work.

Valid subnational codes are available from Subnational1Code List and Search Web Service API

US-PA


deployed

countryCode

either subnational1Code or countryCode is required

n/a

Valid country codes are available from CountryCode List and Search Web Service API

US

 

  deployed

locale

no

en_US

Java standard locale codes

en_US

Language/locale of common names provided in the response (when translations are available)

implemented, not deployed (as of June 27, 2008)

daysBack

no

0

0, 1, 2, 3, 4, 5, 6, 7

7

How many days backwards to look in computing the summary. Zero means use observations submitted for today. One means use observations for today and yesterday.  Etc.

deployed

Result Caching

Results are cached on the server for 30 minutes, so repeated calls to the same URL will usually result in exacted the same response. The time that the response was actually computed is provided in the header time stamp.

...