Notable eBird Sightings Web Service API and Gadget

Gadget

API

URL

description

status

notes

http://ebird.org/ws1.0/data/notable/recent?subnational1Code=US-PA&subnational1Code=US-NY

returns notable sightings for the given state(s)

deployed

 

http://ebird.org/ws1.0/data/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-Subnational1

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
Unknown macro: {import}
  • No labels