Notable eBird Sightings Web Service API and Gadget
Gadget
API
URL |
description |
status |
notes |
---|---|---|---|
http://ebird.org/data/ebird/notable/recent?subnational1Code=US-PA&subnational1Code=US-NY |
returns notable sightings for the given state(s) |
deployed |
|
http://ebird.org/data/ebird/notable/recent?countryCode=US&countryCode=CA |
returns notable sightings for the given country(ies) |
deployed |
|
Parameter Descriptions
parameter |
required |
default |
value options |
example value |
description |
status |
---|---|---|---|---|---|---|
subnational1Code |
either subnational1Code or countryCode is required |
n/a |
Valid subnational codes are available from AKN-1.0-Subnational1List |
US-PA |
There is no limit to the number of subnational1Codes that can be provided in one request. However, subnational1Code and countryCode parameters cannot be provided in the same request. If both are provided, the subnational1Code parameters are ignored. |
deployed |
countryCode |
either subnational1Code or countryCode is required |
n/a |
Valid country codes are available from AKN-1.0-Country |
US |
There is no limit to the number of countryCodes that can be provided in one request. However, subnational1Code and countryCode parameters cannot be provided in the same request. If both are provided, the subnational1Code parameters are ignored. |
deployed |
locale |
no |
en_US |
Java standard locale codes |
en_US |
Language/locale of common names to be provided in the response (when translations are available). This also specifies the language used in the description of the sighting. |
deployed |
Result Caching
Results are cached on the server for 30 minutes, so repeated calls to the same URL will usually result in exactely 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-07-11T14:59:00.659-04:00</timestamp> - <criteria> <property id="subnational11Code" value="US-NY" description="New York"/> <property id="subnational11Code" value="US-PA" description="Pennsylvania"/> </criteria> <comment/> </header> - <result> - <notable-sighting> <sub-id>S3985178</sub-id> <obs-id>OBS55408334</obs-id> <checklist-id>CL21788</checklist-id> - <description> 1 White-crowned Sparrow was observed at Sapsucker Woods in Tompkins County, New York, US on 9 July by CLO Kiosk. </description> <obs-dt>2008-07-09</obs-dt> <species-id>whcspa</species-id> <scientific-name>Zonotrichia leucophrys</scientific-name> <common-name>White-crowned Sparrow</common-name> <loc-id>L97555</loc-id> <location private="false">Sapsucker Woods</location> <longitude>-76.4513778</longitude> <latitude>42.4791969</latitude> <observer>CLO Kiosk</observer> <how-many>1</how-many> <presence-noted>false</presence-noted> <obs-reviewed>false</obs-reviewed> <obs-valid>false</obs-valid> <num-observers>5</num-observers> <subnational2-code>US-NY-109</subnational2-code> <subnational2-name>Tompkins</subnational2-name> <subnational1-code>US-NY</subnational1-code> <subnational1-name>New York</subnational1-name> <country-code>US</country-code> <country-name>United States</country-name> </notable-sighting> - <notable-sighting> <sub-id>S3983932</sub-id> <obs-id>OBS55398293</obs-id> <checklist-id>CL22361</checklist-id> - <description> 1 Greater Scaup was observed at Jamaica Bay Wildlife Refuge in Queens County, New York, US on 8 July by Doug Gochfeld. </description> <obs-dt>2008-07-08</obs-dt> <species-id>gresca</species-id> <scientific-name>Aythya marila</scientific-name> <common-name>Greater Scaup</common-name> <loc-id>L165143</loc-id> <location private="false">Jamaica Bay Wildlife Refuge</location> <longitude>-73.82697</longitude> <latitude>40.62044</latitude> <observer>Doug Gochfeld</observer> <how-many>1</how-many> <presence-noted>false</presence-noted> <obs-reviewed>true</obs-reviewed> <obs-valid>true</obs-valid> <num-observers>2</num-observers> <subnational2-code>US-NY-081</subnational2-code> <subnational2-name>Queens</subnational2-name> <subnational1-code>US-NY</subnational1-code> <subnational1-name>New York</subnational1-name> <country-code>US</country-code> <country-name>United States</country-name> </notable-sighting> - </result> </response>
Potential Enhancements
- add observer name to data and display