Welcome to NatureServe. NatureServe Web Services

n Home?

About NatureServe Web Services
Literature
News Archive

Browse Web Services
Name Search
Get Species Data
Get Ecological Systems
Get Species Location Data
Species Presence Indicator

Technical Resources
Code Samples
Species Schemas
Species Occurrence Schemas
Technical Library

Provide Feedback
Taxonomic Reconciliation
User Registration
Security Administration
Submit User Stories
Contact Us

For NatureServe Data Providers
EO Service
Support Resources

Home

 

arrow For Data Providers

 

arrow Technical Resources

bBrowse Web Services
bSpecies Schemas
bSpecies Occurrence Schemas

 

Subnational Species Summary by Name (public)

Description: This is a service that returns summary information about species found using a name search for a particular subnation (state or canadian province). The search will return zero, one, or many results. The typical reason for running this search is to obtain summary information for species, particularly when the summary XML output is sufficient for a specific purpose. This service allows consumers to avoid making two calls: one to get the brief list with UIDs, a second call to retrieve the species by uid one at a time.

This XML payload is more comprehensive than the Species Search XML in that it includes the Global Species Concept information as well as more conservation status and distribution information.

Service Restrictions: This is a standard service that can be installed at any node, and may return species and UID values for species that are not available via NatureServe Explorer.

Request URL: {baseURL}/idd/rest/v1/subnationalSpecies/summary/nameSearch?

Request Parameters:

Parameter
Value
Description
name string (required) The search string. May use asterisks for wildcard searching. Unlike "google" search, mutliple terms must be in the correct order. E.g., "frog*yellow" will not find "the yellow frog", but "the*frog" will find "the yellow frog".
nationCode string (required) The two-letter ISO nation abbreviation (e.g., "US" or "CA").
subnationCode string (required) The two-letter subnation code (e.g., postal abbreviation) accepted within the specified nation (e.g., "NY").

Response Fields:
The schema document for this service response is located at http://services.natureserve.org/docs/schemas/biodiversityDataFlow/1/0/SummarySpeciesSchema_v1.0.xsd.

See the User Friendly Documents for field details: http://services.natureserve.org/docs/schemas/biodiversityDataFlow/1/0/documentation_summarySpecies_v1.0.xml

Sample Response:

URL: https://services.natureserve.org/idd/rest/v1/subnationalSpecies/summary/nameSearch?nationCode=US&subnationCode=CA&name=*yellow*frog
XML Payload: <?xml version="1.0" encoding="iso-8859-1"?>
<speciesList xmlns="http://services.natureserve.org/docs/schemas/biodiversityDataFlow/1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://services.natureserve.org/docs/schemas/biodiversityDataFlow/1 BiodiversityDataFlow_v1.0.xsd" schemaVersion="1.0">
    <species sensitive="N" uid="ELEMENT_SUBNATIONAL.2.340461" type="Animal" jurisdiction="7" speciesCode="AAABH01140">
        <jurisdictionNationName code="US">UNITED STATES</jurisdictionNationName>
        <jurisdictionSubnationName code="CA">California</jurisdictionSubnationName>
        <subnationalScientificName>
            <unformattedName>Rana muscosa</unformattedName>
            <formattedName>&lt;i&gt;Rana muscosa&lt;/i&gt;</formattedName>
            <nomenclaturalAuthor>Camp, 1917</nomenclaturalAuthor>
        </subnationalScientificName>
        <subnationalConservationStatus>S2</subnationalConservationStatus>
        <roundedSubnationalConservationStatus>S2</roundedSubnationalConservationStatus>
        <subnationalCommonName>mountain yellow-legged frog</subnationalCommonName>
        <natureServeGlobalConcept uid="ELEMENT_GLOBAL.2.105218">
            <classificationStatus>Standard</classificationStatus>
            <natureServeExplorerURI>
            http://www.natureserve.org/explorer/servlet/NatureServe?searchSpeciesUid=ELEMENT_GLOBAL.2.105218
            </natureServeExplorerURI>
            <taxonomicConceptReference code="B85FRO01HQUS">
                <formattedCitation>Frost, Darrel R., ed. 1985. Amphibian species of the world: a taxonomic and geographical reference. Allen Press, Inc., and The Association of Systematics Collections, Lawrence, Kansas. 732 pp.</formattedCitation>
                <unformattedCitation>Frost, Darrel R., ed. 1985. Amphibian species of the world: a taxonomic and geographical reference. Allen Press, Inc., and The Association of Systematics Collections, Lawrence, Kansas. 732 pp.</unformattedCitation>
            </taxonomicConceptReference>
            <nameUsedInConceptReference>
                <unformattedName>Rana muscosa</unformattedName>
                <formattedName>&lt;i&gt;Rana muscosa&lt;/i&gt;</formattedName>
                <nomenclaturalAuthor>Frost</nomenclaturalAuthor>
            </nameUsedInConceptReference>
            <globalScientificName>
                <unformattedName>Rana muscosa</unformattedName>
                <formattedName>&lt;i&gt;Rana muscosa&lt;/i&gt;</formattedName>
                <nomenclaturalAuthor>Camp, 1917</nomenclaturalAuthor>
            </globalScientificName>
            <globalConservationStatus>G2</globalConservationStatus>
            <roundedGlobalConservationStatus>G2</roundedGlobalConservationStatus>
            <globalTaxonomyComments>MtDNA sequence data indicate that R. muscosa consists of four distinct subgroups (northern Sierra, central Sierra, southern Sierra, and southern California) that are potential units for conservation (Macey et al. 2001). A biogeographic break in R. muscosa populations in the Sierra Nevada between Calaveras and Tulare counties also occurs in four additional species of amphibians and reptiles (Macey et al. 2001). MtDNA data suggest that R. aurora, R. cascadae, and R. muscosa form a clade within the R. boylii species group.</globalTaxonomyComments>
        </natureServeGlobalConcept>
        <speciesOccurrenceTrackingStatus>N</speciesOccurrenceTrackingStatus>
        <subnationalDistributions>
            <subnationalDistribution>
                <origin>Native</origin>
                <regularity>Regularly occurring</regularity>
                <currentPresenceAbsence>Present</currentPresenceAbsence>
                <distributionConfidence>Confident</distributionConfidence>
                <population>Year-round</population>
            </subnationalDistribution>
        </subnationalDistributions>
        <metadata>
        </metadata>
    </species>
    <species sensitive="N" uid="ELEMENT_SUBNATIONAL.2.392262" type="Animal" jurisdiction="7" speciesCode="AAABH01050">
        <jurisdictionNationName code="US">UNITED STATES</jurisdictionNationName>
        <jurisdictionSubnationName code="CA">California</jurisdictionSubnationName>
        <subnationalScientificName>
            <unformattedName>Rana boylii</unformattedName>
            <formattedName>&lt;i&gt;Rana boylii&lt;/i&gt;</formattedName>
            <nomenclaturalAuthor>Baird, 1854</nomenclaturalAuthor>
        </subnationalScientificName>
        <subnationalConservationStatus>S2S3</subnationalConservationStatus>
        <roundedSubnationalConservationStatus>S2</roundedSubnationalConservationStatus>
        <subnationalCommonName>foothill yellow-legged frog</subnationalCommonName>
        <natureServeGlobalConcept uid="ELEMENT_GLOBAL.2.102584">
            <classificationStatus>Standard</classificationStatus>
            <natureServeExplorerURI>
            http://www.natureserve.org/explorer/servlet/NatureServe?searchSpeciesUid=ELEMENT_GLOBAL.2.102584
            </natureServeExplorerURI>
            <taxonomicConceptReference code="B85FRO01HQUS">
                <formattedCitation>Frost, Darrel R., ed. 1985. Amphibian species of the world: a taxonomic and geographical reference. Allen Press, Inc., and The Association of Systematics Collections, Lawrence, Kansas. 732 pp.</formattedCitation>
                <unformattedCitation>Frost, Darrel R., ed. 1985. Amphibian species of the world: a taxonomic and geographical reference. Allen Press, Inc., and The Association of Systematics Collections, Lawrence, Kansas. 732 pp.</unformattedCitation>
            </taxonomicConceptReference>
            <nameUsedInConceptReference>
                <unformattedName>Rana boylii</unformattedName>
                <formattedName>&lt;i&gt;Rana boylii&lt;/i&gt;</formattedName>
                <nomenclaturalAuthor>Frost</nomenclaturalAuthor>
            </nameUsedInConceptReference>
            <globalScientificName>
                <unformattedName>Rana boylii</unformattedName>
                <formattedName>&lt;i&gt;Rana boylii&lt;/i&gt;</formattedName>
                <nomenclaturalAuthor>Baird, 1854</nomenclaturalAuthor>
            </globalScientificName>
            <globalConservationStatus>G3</globalConservationStatus>
            <roundedGlobalConservationStatus>G3</roundedGlobalConservationStatus>
            <globalTaxonomyComments>MtDNA data suggest that R. aurora, R. cascadae, and R. muscosa form a clade within the R. boylii species group (Macey et al. 2001).</globalTaxonomyComments>
        </natureServeGlobalConcept>
        <speciesOccurrenceTrackingStatus>N</speciesOccurrenceTrackingStatus>
        <subnationalDistributions>
            <subnationalDistribution>
                <origin>Native</origin>
                <regularity>Regularly occurring</regularity>
                <currentPresenceAbsence>Present</currentPresenceAbsence>
                <distributionConfidence>Confident</distributionConfidence>
                <population>Year-round</population>
            </subnationalDistribution>
        </subnationalDistributions>
        <metadata>
        </metadata>
    </species>
</speciesList>

 

 


 

Copyright © 2007
NatureServe

 
Sitemap www.natureserve.org Contact Us Acknowledgements

Copyright © 2007. NatureServe.

NatureServe.org d Contact Usd Site Mapd Acknowledgements