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 Name Search By National Name (public)

Description: This is a service that returns basic information about species found using a name search for a particular subnation (state or canadian province), using the official names for the nation. The search will return zero, one, or many results. The typical reason for running this search is to obtain the species UID which can be used in a subsequent call to retrieve more information about that species.

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/list/nameSearchByNationalName?

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/NatureServeResultContainers_v1.0.xsd.

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

Sample Response:

URL: https://services.natureserve.org/idd/rest/v1/subnationalSpecies/list/nameSearchByNationalName?nationCode=CA&name=Pseudacris%20maculata
XML Payload: <?xml version="1.0" encoding="iso-8859-1"?>
<speciesSearchReport 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">
    <conditions>
        <match>
            <searchTerm>Pseudacris maculata</searchTerm>
        </match>
    </conditions>
    <speciesSearchResultList>
        <speciesSearchResult uid="ELEMENT_SUBNATIONAL.2.272846">
            <globalSpeciesUid>ELEMENT_GLOBAL.2.102184</globalSpeciesUid>
            <natureServeExplorerURI>
            http://www.natureserve.org/explorer/servlet/NatureServe?searchSpeciesUid=ELEMENT_GLOBAL.2.102184
            </natureServeExplorerURI>
            <jurisdictionNationName code="CA">CANADA</jurisdictionNationName>
            <jurisdictionSubnationName code="QC">Quebec</jurisdictionSubnationName>
            <jurisdictionScientificName>Pseudacris maculata</jurisdictionScientificName>
            <commonName language="en">rainette faux-grillon boréale</commonName>
            <taxonomicComments>pseudacris triseriata maculata</taxonomicComments>
        </speciesSearchResult>
        <speciesSearchResult uid="ELEMENT_SUBNATIONAL.2.288811">
            <globalSpeciesUid>ELEMENT_GLOBAL.2.102184</globalSpeciesUid>
            <natureServeExplorerURI>
            http://www.natureserve.org/explorer/servlet/NatureServe?searchSpeciesUid=ELEMENT_GLOBAL.2.102184
            </natureServeExplorerURI>
            <jurisdictionNationName code="CA">CANADA</jurisdictionNationName>
            <jurisdictionSubnationName code="ON">Ontario</jurisdictionSubnationName>
            <jurisdictionScientificName>Pseudacris maculata</jurisdictionScientificName>
            <commonName language="en">Boreal Chorus Frog</commonName>
        </speciesSearchResult>
        <speciesSearchResult uid="ELEMENT_SUBNATIONAL.9.16341">
            <globalSpeciesUid>ELEMENT_GLOBAL.2.102184</globalSpeciesUid>
            <natureServeExplorerURI>
            http://www.natureserve.org/explorer/servlet/NatureServe?searchSpeciesUid=ELEMENT_GLOBAL.2.102184
            </natureServeExplorerURI>
            <jurisdictionNationName code="CA">CANADA</jurisdictionNationName>
            <jurisdictionSubnationName code="BC">British Columbia</jurisdictionSubnationName>
            <jurisdictionScientificName>Pseudacris maculata</jurisdictionScientificName>
            <commonName language="en">Boreal Chorus Frog</commonName>
        </speciesSearchResult>
        <speciesSearchResult uid="ELEMENT_SUBNATIONAL.78.637272">
            <globalSpeciesUid>ELEMENT_GLOBAL.2.102184</globalSpeciesUid>
            <natureServeExplorerURI>
            http://www.natureserve.org/explorer/servlet/NatureServe?searchSpeciesUid=ELEMENT_GLOBAL.2.102184
            </natureServeExplorerURI>
            <jurisdictionNationName code="CA">CANADA</jurisdictionNationName>
            <jurisdictionSubnationName code="YT">Yukon Territory</jurisdictionSubnationName>
            <jurisdictionScientificName>Pseudacris maculata</jurisdictionScientificName>
            <commonName language="en">boreal chorus frog</commonName>
        </speciesSearchResult>
        <speciesSearchResult uid="ELEMENT_SUBNATIONAL.2.797914">
            <globalSpeciesUid>ELEMENT_GLOBAL.2.102184</globalSpeciesUid>
            <natureServeExplorerURI>
            http://www.natureserve.org/explorer/servlet/NatureServe?searchSpeciesUid=ELEMENT_GLOBAL.2.102184
            </natureServeExplorerURI>
            <jurisdictionNationName code="CA">CANADA</jurisdictionNationName>
            <jurisdictionSubnationName code="SK">Saskatchewan</jurisdictionSubnationName>
            <jurisdictionScientificName>Pseudacris maculata</jurisdictionScientificName>
            <commonName language="en">Boreal Chorus Frog</commonName>
            <taxonomicComments>P.t. maculata possibly a distinct species. Contact zone with P.t. triseriata is outside Saskatchewan. Pseudacris triseriata maculata is the subspecies occuring in Saskatchewan (REF?).</taxonomicComments>
        </speciesSearchResult>
        <speciesSearchResult uid="ELEMENT_SUBNATIONAL.2.797925">
            <globalSpeciesUid>ELEMENT_GLOBAL.2.102184</globalSpeciesUid>
            <natureServeExplorerURI>
            http://www.natureserve.org/explorer/servlet/NatureServe?searchSpeciesUid=ELEMENT_GLOBAL.2.102184
            </natureServeExplorerURI>
            <jurisdictionNationName code="CA">CANADA</jurisdictionNationName>
            <jurisdictionSubnationName code="AB">Alberta</jurisdictionSubnationName>
            <jurisdictionScientificName>Pseudacris maculata</jurisdictionScientificName>
            <commonName language="en">Striped Chorus Frog</commonName>
        </speciesSearchResult>
        <speciesSearchResult uid="ELEMENT_SUBNATIONAL.2.797915">
            <globalSpeciesUid>ELEMENT_GLOBAL.2.102184</globalSpeciesUid>
            <natureServeExplorerURI>
            http://www.natureserve.org/explorer/servlet/NatureServe?searchSpeciesUid=ELEMENT_GLOBAL.2.102184
            </natureServeExplorerURI>
            <jurisdictionNationName code="CA">CANADA</jurisdictionNationName>
            <jurisdictionSubnationName code="MB">Manitoba</jurisdictionSubnationName>
            <jurisdictionScientificName>Pseudacris triseriata maculata</jurisdictionScientificName>
            <commonName language="en">Boreal Chorus Frog</commonName>
            <taxonomicComments>Also called striped chorus frog (Cook 1984).</taxonomicComments>
        </speciesSearchResult>
        <speciesSearchResult uid="ELEMENT_SUBNATIONAL.2.797924">
            <globalSpeciesUid>ELEMENT_GLOBAL.2.102184</globalSpeciesUid>
            <natureServeExplorerURI>
            http://www.natureserve.org/explorer/servlet/NatureServe?searchSpeciesUid=ELEMENT_GLOBAL.2.102184
            </natureServeExplorerURI>
            <jurisdictionNationName code="CA">CANADA</jurisdictionNationName>
            <jurisdictionSubnationName code="NT">Northwest Territories</jurisdictionSubnationName>
            <jurisdictionScientificName>Pseudacris maculata</jurisdictionScientificName>
        </speciesSearchResult>
    </speciesSearchResultList>
</speciesSearchReport>

 


 
Copyright © 2007
NatureServe
  
Sitemap www.natureserve.org Contact Us Acknowledgements

Copyright © 2007. NatureServe.

NatureServe.org d Contact Usd Site Mapd Acknowledgements