GEOSS - GEOSS Registry System

GEOSS Component and Service Registry - API Interface

The GEOSS registry exposes OGC CSW interfaces to be accessed by other applications, including GEOSS Web Portal solutions. The UDDI and OASIS ebXML-ebRS interfaces will be ready soon. Clearinghouse implementations can use the GEOSS registry to register and locate GEOSS catalog services as a basis for evaluation, configuration, harvest, and distributed query.

This OGC CSW Interface follows OGC 07-006r1: OpenGIS Catalogue Service Implementation Specification (Ver.2.0.2), HTTP Protocol Binding. It supports GetCapabilities, DescribeRecord, and GetRecords funtions.

Service Address

http://geossregistries.info:1090/GEOSSCSW202/discovery

GetCapabilities

The mandatory GetCapabilities operation allows CSW clients to retrieve service metadata from a server. The response to a GetCapabilities request shall be an XML document containing service metadata about the server. This subclause specifies the XML document that a CSW server shall return to describe its capabilities.

This GetCapabilities HTTP Get Request Sample contains the following KVPs:

Request=GetCapabilities
Service=CSW
Version=2.0.2

DescribeRecord

The mandatory DescribeRecord operation allows a client to discover elements of the information model supported by the target catalogue service. The operation allows some or all of the information model to be described.

This DescribeRecord HTTP Get Request Sample contains the following KVPs:

Request=DescribeRecord
Service=CSW
Version=2.0.2
NAMESPACE=xmlns(rim=urn:oasis:names:tc:ebxml-regrep:xsd:rim:3.0)

GetRecords

The mandatory GetRecords operation works as the primary mean of resource discovery in the HTTP protocal binding. It does a search and a piggybacked present. Only XML encoding is supported at this moment.

GetRecords Request XML Encoding Examples

Request Example - for Component

This query is for the component that its name is "U.S. Geospatial One-Stop".

Request Example 1 - for Service

This query is for those services that their names contain "Geospatial One Stop".

Request Example 2 - for Service

This query is for those Catalog/Registry Services, no matter what kind of version it supports, no matter which application profile it follows.

<?xml version="1.0" encoding="UTF-8"?>
<csw:GetRecords
 xmlns="http://www.opengis.net/cat/csw" 
 xmlns:csw="http://www.opengis.net/cat/csw" 
 xmlns:ogc="http://www.opengis.net/ogc" 
 xmlns:gml="http://www.opengis.net/gml" 
 xmlns:rim="urn:oasis:names:tc:ebxml-regrep:xsd:rim:3.0"
 version="2.0.2" 
 outputFormat="text/xml; charset=UTF-8" 
 outputSchema="http://www.opengis.net/cat/csw" 
 maxRecords="1"
 startPosition="1">
 <csw:Query typeNames="rim:Service">
  <csw:ElementName>/rim:Service/</csw:ElementName>
  <csw:Constraint version="1.1.0">
   <ogc:Filter>
    <ogc:And>
     <ogc:PropertyIsEqualTo>
      <ogc:PropertyName>/rim:Service/rim:Slot/@name</ogc:PropertyName>
      <ogc:Literal>standardTypes</ogc:Literal>
     </ogc:PropertyIsEqualTo>
     <ogc:PropertyIsEqualTo>
      <ogc:PropertyName>/rim:Service/rim:Slot/rim:ValueList/rim:Value</ogc:PropertyName>
      <ogc:Literal>Catalog/Registry Service</ogc:Literal>
     </ogc:PropertyIsEqualTo>
    </ogc:And>
   </ogc:Filter>
  </csw:Constraint>
 </csw:Query>
</csw:GetRecords>

Request Example 3 - for Service

This query is ONLY for those Catalog/Registry Services that support OGC Catalogue Service 2.0.1 - Z39.50 binding.

<?xml version="1.0" encoding="UTF-8"?>
<csw:GetRecords
 xmlns="http://www.opengis.net/cat/csw" 
 xmlns:csw="http://www.opengis.net/cat/csw" 
 xmlns:ogc="http://www.opengis.net/ogc" 
 xmlns:gml="http://www.opengis.net/gml" 
 xmlns:rim="urn:oasis:names:tc:ebxml-regrep:xsd:rim:3.0"
 version="2.0.2" 
 outputFormat="text/xml; charset=UTF-8" 
 outputSchema="http://www.opengis.net/cat/csw" 
 maxRecords="1"
 startPosition="1">
 <csw:Query typeNames="rim:Service">
  <csw:ElementName>/rim:Service/</csw:ElementName>
  <csw:Constraint version="1.1.0">
   <ogc:Filter>
    <ogc:And>
     <ogc:PropertyIsEqualTo>
      <ogc:PropertyName>/rim:Service/rim:Slot/@name</ogc:PropertyName>
      <ogc:Literal>standards</ogc:Literal>
     </ogc:PropertyIsEqualTo>
     <ogc:PropertyIsEqualTo>
      <ogc:PropertyName>/rim:Service/rim:Slot/rim:ValueList/rim:Value</ogc:PropertyName>
      <ogc:Literal>urn:ogc:serviceType:CatalogueService:2.0.1:Z39.50</ogc:Literal>
     </ogc:PropertyIsEqualTo>
    </ogc:And>
   </ogc:Filter>
  </csw:Constraint>
 </csw:Query>
</csw:GetRecords>

Request Example 4 - for Service

This query is ONLY for those Catalog/Registry Services that support OGC Catalogue Service 2.0.1 - HTTP binding - ISO19115/19119 application profile.

<?xml version="1.0" encoding="UTF-8"?>
<csw:GetRecords
 xmlns="http://www.opengis.net/cat/csw" 
 xmlns:csw="http://www.opengis.net/cat/csw" 
 xmlns:ogc="http://www.opengis.net/ogc" 
 xmlns:gml="http://www.opengis.net/gml" 
 xmlns:rim="urn:oasis:names:tc:ebxml-regrep:xsd:rim:3.0"
 version="2.0.2" 
 outputFormat="text/xml; charset=UTF-8" 
 outputSchema="http://www.opengis.net/cat/csw" 
 maxRecords="1"
 startPosition="1">
 <csw:Query typeNames="rim:Service">
  <csw:ElementName>/rim:Service/</csw:ElementName>
  <csw:Constraint version="1.1.0">
   <ogc:Filter>
    <ogc:And>
     <ogc:PropertyIsEqualTo>
      <ogc:PropertyName>/rim:Service/rim:Slot/@name</ogc:PropertyName>
      <ogc:Literal>standards</ogc:Literal>
     </ogc:PropertyIsEqualTo>
     <ogc:PropertyIsEqualTo>
      <ogc:PropertyName>/rim:Service/rim:Slot/rim:ValueList/rim:Value</ogc:PropertyName>
      <ogc:Literal>urn:ogc:serviceType:CatalogueService:2.0.1:HTTP:ISO19115/19119</ogc:Literal>
     </ogc:PropertyIsEqualTo>
    </ogc:And>
   </ogc:Filter>
  </csw:Constraint>
 </csw:Query>
</csw:GetRecords>

GetRecords Response Examples

Response Example - for Component

<?xml version="1.0" encoding="ISO-8859-1"?>
<csw:GetRecordsResponse 
  targetNamespace="http://www.opengis.net/cat/csw" 
  xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
  xmlns:csw="http://www.opengis.net/cat/csw" 
  xmlns:rim="urn:oasis:names:tc:ebxml-regrep:xsd:rim:3.0" 
  xmlns:ogc="http://www.opengis.net/ogc" 
  elementFormDefault="qualified" version="2.0.2">
  <csw:SearchStatus status="complete" timestamp="2007.07.02.23.28.30"/>
  <csw:SearchResults numberOfRecordsMatched="1" numberOfRecordsReturned="1" nextRecord="0">
    <Organization 
      primaryContact="urn:uuid:3d917f2e-4114-4ba7-bb76-a766be4b288f" 
      lid="urn:uuid:4509b59b-ce95-4d71-ae1c-a7dc04867606" 
      objectType="urn:oasis:names:tc:ebxml-regrep:ObjectType:RegistryObject:Organization" 
      status="urn:oasis:names:tc:ebxml-regrep:StatusType:Submitted" 
      id="urn:uuid:4509b59b-ce95-4d71-ae1c-a7dc04867606" 
      xmlns="urn:oasis:names:tc:ebxml-regrep:xsd:rim:3.0">
      <Slot name="Approval">
	    <ValueList><Value>no</Value></ValueList>
      </Slot>
      <Slot name="Catalogue">
        <ValueList>
          <Value>http://www.geodata.gov/aimscsw/csw2.0.1?service=CSW&request=getcapabilities</Value>
        </ValueList>
      </Slot>
      <Slot name="Category">
        <ValueList>
          <Value>dataExchangeAndDisseminationSystem</Value>
        </ValueList>
      </Slot>
      <Slot name="ContactEmail">
        <ValueList><Value>support@geodata.gov</Value></ValueList>
      </Slot>
      <Slot name="ContactName">
        <ValueList><Value>User Support</Value></ValueList>
      </Slot>
      <Slot name="GeoSponsor">
        <ValueList><Value>M0068</Value></ValueList>
      </Slot>
      <Slot name="OnLineRef">
        <ValueList><Value>http://geodata.gov</Value></ValueList>
      </Slot>
      <Slot name="OrganizationType">
        <ValueList><Value>GEOSSComponent</Value></ValueList>
      </Slot>
      <Slot name="Owner">
        <ValueList><Value>ddnebert</Value></ValueList>
      </Slot>
      <Slot name="RespOrg">
        <ValueList><Value>U.S. Geological Survey</Value></ValueList>
      </Slot>
      <Slot name="SocietalBenefit">
        <ValueList>
          <Value>Agriculture</Value>
          <Value>Biodiversity</Value>
          <Value>Climate</Value>
          <Value>Disasters</Value>
          <Value>Ecosystems</Value>
          <Value>Energy</Value>
          <Value>Health</Value>
          <Value>Water</Value>
          <Value>Weather</Value>
        </ValueList>
      </Slot>
      <Slot name="Status">
        <ValueList><Value>continuousOperation</Value></ValueList>
      </Slot>
      <Slot name="componentAbbrev">
        <ValueList><Value>geodata.gov</Value></ValueList>
      </Slot>
      <Name>
        <LocalizedString charset="UTF-8" value="U.S. Geospatial One-Stop" xml:lang="en-US"/>
      </Name>
      <Description>
        <LocalizedString charset="UTF-8" value="This Component provides comprehensive access to U.S. geospatial data and services. It enables publishing of data sets through the collection or harvest of descriptive metadata and enables search and visualization of geospatial data through certain standards-based services." xml:lang="en-US"/>
      </Description>
      <VersionInfo versionName="1.1"/>
      <Address/>
    </Organization>
  </csw:SearchResults>
</csw:GetRecordsResponse>

Response Example - for Service

<?xml version="1.0" encoding="ISO-8859-1"?>
<csw:GetRecordsResponse 
 targetNamespace="http://www.opengis.net/cat/csw"
 xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
 xmlns:csw="http://www.opengis.net/cat/csw" 
 xmlns:rim="urn:oasis:names:tc:ebxml-regrep:xsd:rim:3.0" 
 xmlns:ogc="http://www.opengis.net/ogc" 
 elementFormDefault="qualified" 
 version="2.0.2">  
 <csw:SearchStatus status="complete" timestamp="2007.07.02.23.07.18"/>
 <csw:SearchResults numberOfRecordsMatched="1"   numberOfRecordsReturned="1" nextRecord="0">
  <Service 
   lid="urn:uuid:d9840427-d361-480c-a7d6-d26cfe48e320"
   objectType="urn:oasis:names:tc:ebxml-regrep:ObjectType:RegistryObject:Service"
   status="urn:oasis:names:tc:ebxml-regrep:StatusType:Submitted"
   id="urn:uuid:d9840427-d361-480c-a7d6-d26cfe48e320"
   xmlns="urn:oasis:names:tc:ebxml-regrep:xsd:rim:3.0">
   <Slot name="ContactEmail">
    <ValueList><Value>support@geodata.gov</Value></ValueList>
   </Slot>
   <Slot name="ContactName">
    <ValueList><Value>User Support</Value></ValueList>
   </Slot>
   <Slot name="OnLineRef">
    <ValueList>
     <Value>http://www.geodata.gov/aimscsw/csw2.0?service=CSW&request=getcapabilities</Value>
    </ValueList>
   </Slot>
   <Slot name="Owner">
    <ValueList><Value>ddnebert</Value></ValueList>
   </Slot>
   <Slot name="ServiceType">
    <ValueList><Value>GEOSSService</Value></ValueList>
   </Slot>
   <Slot name="abbrev">
    <ValueList><Value>gos-csw</Value></ValueList>
   </Slot>
   <Slot name="beginDate">
    <ValueList><Value>Indefinite Start</Value></ValueList>
   </Slot>
   <Slot name="endDate">
    <ValueList><Value>Ongoing</Value></ValueList>
   </Slot>
   <Slot name="geoss">
    <ValueList><Value>yes</Value></ValueList>
   </Slot>
   <Slot name="maxLat">
    <ValueList><Value>71.0</Value></ValueList>
   </Slot>
   <Slot name="maxLong">
    <ValueList><Value>-65.0</Value></ValueList>
   </Slot>
   <Slot name="minLat">
    <ValueList><Value>18.0</Value></ValueList>
   </Slot>
   <Slot name="minLong">
    <ValueList><Value>-180.0</Value></ValueList>
   </Slot>
   <Slot name="providingOrganization">
    <ValueList>
     <Value>urn:uuid:4509b59b-ce95-4d71-ae1c-a7dc04867606</Value>
    </ValueList>
   </Slot>
   <Slot name="serviceInfo">
    <ValueList><Value>http://geodata.gov</Value></ValueList>
   </Slot>
   <Slot name="standardTypes">
    <ValueList>
     <Value>Metadata</Value>
     <Value>Catalog/Registry Service</Value>
    </ValueList>
   </Slot>
   <Slot name="standards">
    <ValueList>
     <Value>USA FGDC CSDGM</Value>
     <Value>urn:ogc:serviceType:CatalogueService:2.0.1:HTTP:FGDC-CSDGM</Value>
    </ValueList>
   </Slot>
   <Name>
    <LocalizedString 
      charset="UTF-8" 
      value="Geospatial One Stop Catalog Service (OGC CSW FGDC)" 
      xml:lang="en-US"/>
   </Name>
   <Description>
    <LocalizedString 
     charset="UTF-8" 
     value="This interface provides standard access to the Geospatial One Stop national metadata catalog through the Open Geospatial Consortium (OGC) Catalogue Service interface, Version 2.0.1 supporting the FGDC Profile." 
     xml:lang="en-US"/>
   </Description>
   <VersionInfo versionName="1.1"/>
  </Service>
 </csw:SearchResults>
</csw:GetRecordsResponse>

Last updated: December 13, 2007