Recent eBird Sightings Summary By Loc Web Service API and Gadget
Gadget
The sample gadget utilizing this API: http://ebird.org/wstools1.0/google/byloc/ett-byloc.xml.
Example of this gadget on a page: http://ebird.org/wstools1.0/google/byloc/sample/sample-estero-llano.html
API
URL |
description |
status |
notes |
---|---|---|---|
Return summary of recent sightings for most active hotspot over the past 24 hours |
deployed |
|
|
http://ebird.org/ws1.0/product/byloc/recent?locID=L97555&locID=L259855&daysBack=7 |
Return summary of recent sightings at the given locID(s) |
deployed |
|
Parameter Descriptions
parameter |
required |
default |
value options |
example value |
description |
status |
---|---|---|---|---|---|---|
locID |
no |
n/a |
locID of hotspot locations |
L97555 |
The data summary is computed using data submitted to the given locIDs (up to three). |
deployed |
locale |
no |
en_US |
Java standard locale codes |
en_US |
Language/locale of common names provided in the response (when translations are available) |
deployed |
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.
XML Result Format
<?xml version="1.0" encoding="UTF-8"?> <response> <header> <locale country="US" language="en"/> <timestamp>2008-06-27T15:57:58.877-04:00</timestamp> <criteria> <property id="locID" value="L97555" description="Sapsucker Woods"/> <property id="daysBack" value="7"/> </criteria> </header> <result> <sighting> <species-id>cangoo</species-id> <scientific-name>Branta canadensis</scientific-name> <common-name>Canada Goose</common-name> <how-many>20</how-many> <num-checklists>2</num-checklists> <obs-dt>2008-06-27</obs-dt> </sighting> <sighting> <species-id>norbob</species-id> <scientific-name>Colinus virginianus</scientific-name> <common-name>Northern Bobwhite</common-name> <how-many>1</how-many> <num-checklists>1</num-checklists> <obs-dt>2008-06-25</obs-dt> </sighting> </result> </response>
Enhancements
- Link to AAB species instead of eBird reports
- link to map showing location of sighting (using kiosk map)
- Identfiy rarities and specialties
- Multiple time frames (week, month); for these, show date last observed
- Support multiple points (via polygon)