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

 

National Species Summary by Name (public)

Description: This is a service that returns summary information about species found using a name search for a particular nation. 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/nationalSpecies/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").

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/nationalSpecies/summary/nameSearch?nationCode=CA&name=Colin*des*montagnes
XML Payload: <?xml version="1.0" encoding="iso-8859-1"?>
<speciesList xsi:schemaLocation="http://services.natureserve.org/docs/schemas/biodiversityDataFlow/1 BiodiversityDataFlow_v1.0.xsd" xmlns="http://services.natureserve.org/docs/schemas/biodiversityDataFlow/1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" schemaVersion="1.0">
    <species uid="ELEMENT_NATIONAL.2.162045" type="Animal">
        <jurisdictionNationName code="CA">CANADA</jurisdictionNationName>
        <otherIdentifiers>
            <otherIdentifier typeName="Canada General Status">
                <identifierLeadOrganization>Canada General Status</identifierLeadOrganization>
                <identifierValue>416</identifierValue>
            </otherIdentifier>
        </otherIdentifiers>
        <nationalScientificName>
            <unformattedName>Oreortyx pictus</unformattedName>
            <formattedName>&lt;i&gt;Oreortyx pictus&lt;/i&gt;</formattedName>
            <nomenclaturalAuthor>(Douglas, 1829)</nomenclaturalAuthor>
        </nationalScientificName>
        <nationalConservationStatus lastChangedDate="2001-01-12" lastReviewedDate="2001-01-12">NNA</nationalConservationStatus>
        <roundedNationalConservationStatus>NNA</roundedNationalConservationStatus>
        <nationalCommonName>Mountain Quail</nationalCommonName>
        <otherNationalCommonNames>
            <commonName language="fr">Colin des montagnes</commonName>
        </otherNationalCommonNames>
        <natureServeGlobalConcept uid="ELEMENT_GLOBAL.2.104712">
            <classificationStatus>Standard</classificationStatus>
            <natureServeExplorerURI>
            http://www.natureserve.org/explorer/servlet/NatureServe?searchSpeciesUid=ELEMENT_GLOBAL.2.104712
            </natureServeExplorerURI>
            <taxonomicConceptReference code="B98AOU01NAUS">
                <formattedCitation>American Ornithologists' Union (AOU). 1998. Check-list of North American birds. Seventh edition. American Ornithologists' Union, Washington, DC. 829 pp.</formattedCitation>
                <unformattedCitation>American Ornithologists' Union (AOU). 1998. Check-list of North American birds. Seventh edition. American Ornithologists' Union, Washington, DC. 829 pp.</unformattedCitation>
            </taxonomicConceptReference>
            <nameUsedInConceptReference>
                <unformattedName>Oreortyx pictus</unformattedName>
                <formattedName>&lt;i&gt;Oreortyx pictus&lt;/i&gt;</formattedName>
                <nomenclaturalAuthor>American Ornithologists' Union (AOU)</nomenclaturalAuthor>
            </nameUsedInConceptReference>
            <globalScientificName>
                <unformattedName>Oreortyx pictus</unformattedName>
                <formattedName>&lt;i&gt;Oreortyx pictus&lt;/i&gt;</formattedName>
                <nomenclaturalAuthor>(Douglas, 1829)</nomenclaturalAuthor>
            </globalScientificName>
            <globalConservationStatus>G5</globalConservationStatus>
            <roundedGlobalConservationStatus>G5</roundedGlobalConservationStatus>
            <globalTaxonomyComments>Formerly in family Phasianidae; placed in family Odontophoridae by AOU (1997).</globalTaxonomyComments>
        </natureServeGlobalConcept>
        <nationalDistributions>
            <nationalDistribution>
                <origin>Exotic</origin>
                <regularity>Regularly occurring</regularity>
                <currentPresenceAbsence>Present</currentPresenceAbsence>
                <distributionConfidence>Confident</distributionConfidence>
                <population>Year-round</population>
            </nationalDistribution>
        </nationalDistributions>
        <otherStatuses>
            <status name="Canada General Status">
                <statusValue>Not assessed</statusValue>
                <statusDate>2000-12-31</statusDate>
            </status>
            <status name="Exotic">
                <statusValue>NE1</statusValue>
                <statusDate>2001-01-12</statusDate>
            </status>
        </otherStatuses>
        <metadata>
            <references>
                      </references>
        </metadata>
    </species>
</speciesList>



 

Copyright © 2007
NatureServe

 
Sitemap www.natureserve.org Contact Us Acknowledgements

Copyright © 2007. NatureServe.

NatureServe.org d Contact Usd Site Mapd Acknowledgements