eBird Hot Spot List
...
- Version 1.0
Panel | ||||
---|---|---|---|---|
|
Summary
Get a list of eBird hotspots, for a state or for a country. The eBird Hot Spots Examples page contains links for this API for each state and province in the US and Canada.
API
URI | description | status | notes |
---|---|---|---|
ws1.0/data/hotspot/list?countryCode=<2-letter ISO country code> | Return list of hotspots found in the given country | coded and deployed |
|
ws1.0/data/hotspot/list?subnational1Code=<subnational1 code> | Return list of hotspots names found in the given "state" | coded and deployed |
|
parameter | required | default | value options | description | status |
---|---|---|---|---|---|
countryCode | one of countryCode or subnational1Code is required | n/a | see AKN-1.0-Country | coded and deployed | |
subnational1Code | one of countryCode or subnational1Code is required | n/a | coded and deployed | ||
format | no | csv | csv, xml | format to use for response; this parameter is case sensitive | coded and deployed |
Test URLS
Caching
Responses to this API are cached up to 24 hours hours on our servers. Because of this, API consumers might see inconsistencies between various calls submitted at the same time (e.g. a particular US-VA hot spot is included in the response to a request for all the US-VA hot spots, but it is not included in a request submitted at the same time listing all the US hot spots). In the XML response format, the time stamp in the header section shows the time that the response was originally created, and so API consumers can see the age of the particular response.
CSV Result Format
Panel |
---|
<loc ID>, <country code>, <subnational1 code>, <latitude>, <longitude>, "<name>" |
...
Panel |
---|
L453718, US, US-RI, 41.3302, -71.8375, "Avondale Farm" |
XML Result Format
Example
No Format |
---|
<?xml version="1.0" encoding="UTF-8"?> <response> <header> <locale country="US" language="en"/> <timestamp>2008-07-25T10:54:16.432-04:00</timestamp> <criteria> <property id="subnational11Code" value="US-RI" description="Rhode Island"/> </criteria> <comment/> </header> <result> <hotspot> <loc-id>L453718</loc-id> <location>Avondale Farm</location> <longitude>-71.8375</longitude> <latitude>41.3302</latitude> <subnational1-code>US-RI</subnational1-code> <country-code>US</country-code> </hotspot> <hotspot> <loc-id>L231740</loc-id> <location>Beavertail State Park</location> <longitude>-71.3987547</longitude> <latitude>41.4496915</latitude> <subnational1-code>US-RI</subnational1-code> <country-code>US</country-code> </hotspot> </result> </response> |
Potential Improvements
- Add summary info to each record:
- # of checklists per hotspot
- Add KML format option to produce GoogleEarth/Map compatible files.
Wiki Markup |
---|
{import:eBird-footer} |