Wiki Markup |
---|
{toc}
h2. Description
Returns a list of all species in the eBird taxonomy for the given combination of categories. The default category is "species". Any taxon with the category of 'species' may be used as a parameter in service calls that take a scientific name. Any taxon not in this category will be rejected by these services at this time.
This is part of the [eBird version 1.1 API|eBird API 1.1].
h2. URL
*Base URL*
[http://ebird.org/ws1.1/ref/taxa]
*Examples*
Minimal:
[http://ebird.org/ws1.1/ref/taxa/ebird]
Fully specified:
[http://ebird.org/ws1.1/ref/taxa/ebird?cat=species&fmt=xml&locale=en_US]
h2. Parameter Descriptions
|| Parameter Name || Required || Default || Value Options || Example Value || Description ||
| cat | no | species | domestic,form,hybrid,intergrade,issf,slash,species,spuh | hybrid | For more info about the meaning of species categories, see [http://ebird.org/content/ebird/about/ebird-taxonomy] |
| locale | no | en_US | fr_CA,es_MX,es_PR,ht_HT,fr,fr_HT,es_CU,es_PA,es_DO,en_NZ,es,es_CL | fr_CA | The locale for the taxon common name |
| fmt \\ | no \\ | csv \\ | xml,csv \\ | xml \\ | |
h3. Resources
The human readable version of the current eBird taxonomy can also be downloaded [here|http://ebird.org/content/ebird/about/ebird-taxonomy].
h2. Result Fields
|| *Field (XML)* || *Description* ||
| sci-name | Scientific name |
| com-name | Common name |
| taxon-id | Taxonomic Concept identifier, note this is currently in test |
h3. Example Responses
h4. CSV
{noformat}
Rhea americana,Greater Rhea,TC000004
Rhea pennata,Lesser Rhea, TC000005
{noformat}
h4. XML
{noformat}
<response>
<header>
<locale country="" language="en"/>
<timestamp>
2009-07-08T10:39:42.150-04:00
</timestamp>
<criteria>
<locale country="" language="en"/>
<cat>
species
</cat>
<fmt>
xml
</fmt>
</criteria>
</header>
<result>
<taxa>
<com-name>
Greater Rhea
</com-name>
<sci-name>
Rhea americana
</sci-name>
<taxon-id>
TC00000004
</taxon-id>
</taxa>
<taxa>
<com-name>
Lesser Rhea
</com-name>
<sci-name>
Rhea pennata
</sci-name>
<taxon-id>
TC00000005
</taxon-id>
</taxa>
</response>
{noformat}
h2. Caching Information
For details on caching of results by our servers, see [eBird-1.1-CacheInformation|eBird-1.1-CacheInformation]
{import:eBird-footer} |
Page History
Overview
Content Tools