|
|
 |
Web Service Hierarchy APIs
| Get
Full Hierarchy From TSN |
Description
|
Returns the Taxonomic Hierarchy from the kingdom to the
requested scientific name, and the immediate children of
the scientific name.
|
Input
|
A
string containing the ITIS TSN. |
Output
|
The
resulting hierarchy as a list of string sets containing the TSN,
taxonomic rank and scientific name, or an empty result set if there is
no TSN match.
|
Example
|
http://www.itis.gov/ITISWebService/services/ITISService/getFullHierarchyFromTSN?tsn=558090
|
| Get
Hierarchy Down From TSN |
Description
|
Returns
a list of all the valid/accepted scientific names contained within a
particular valid/accepted scientific name and their TSNs, limited to
immediate children only. The result set will be found by comparing the
search key to the parent TSN field.
Note: There
is the possibility that this could return a sizable set of data. For
example, if searching with the TSN for Animalia (TSN 202423), the
returned group would be all records in the Animalia tree. Because of
this, this function will only return the immediate children of the
search key (i.e. searching for Animalia's TSN would return the phyla
directly linked to it, and the names of any other rank directly linked
to it).
|
Input
|
A
string containing the ITIS TSN. |
Output
|
A
set of strings containing the TSNs and the corresponding scientific
names, or an empty result set if there is no TSN match or the
scientific name is at the bottom of the hierarchy.
|
Example
|
http://www.itis.gov/ITISWebService/services/ITISService/getHierarchyDownFromTSN?tsn=178265
|
| Get
Hierarchy Up From TSN |
Description
|
Returns
the parent of the TSN (i.e. the parent of the current scientific name
in the taxonomic hierarchy) found by comparing the search key to the
ITIS TSN field.
|
Input
|
A
string containing the ITIS TSN. |
Output
|
A
string containing the resulting TSN, or an empty result set if there is
no TSN match or the scientific name is at the top of the hierarchy.
|
Example
|
http://www.itis.gov/ITISWebService/services/ITISService/getHierarchyUpFromTSN?tsn=1378
|
|
|
