DescribeFeatureType optional Change Requests | OGC

Copyright © 2007 Open Geospatial Consortium, Inc. All Rights Reserved. 47 gml:TimePeriod xmlns:gml = http:www.opengis.netgml gml:beginPosition 2005-10-25T14:45:00.000Z gml:beginPosition gml:endPosition 2005-11-01T01:25:00.000Z gml:endPosition gml:TimePeriod

10.5 DescribeFeatureType optional

10.5.1 Introduction

DescribeFeatureType returns the XML schema for the specified GML feature advertised in GetCapabilities. This may be used to obtain a description of the type of an observation feature-of-interest.

10.5.2 Request

Figure 10-5 Parameters for DescribeFeatureType Request Table 11. Parameters of DescribeFeatureType Request Name a Definition Data type and values Multiplicity and use service Service type identifier SOS One mandatory version Specification version for operation Supported version of SOS One mandatory FeatureId The xlink:href of the feature of interest from the capabilities document. anyURI One mandatory a The name capitalization rules being used here are specified in Subclause 11.6.2 of [OGC 06-121r3].

10.5.3 Response

The response to a DescribeFeatureType request is the XML Schema that defines the feature type for the specified feature.

10.5.4 Exceptions

When a SOS server encounters an error while performing a DescribeFeatureType operation, it shall return an exception report message as specified in clause 8 of [OGC 06-121r3]. 48 Copyright © 2007 Open Geospatial Consortium, Inc. All Rights Reserved.

10.5.5 Examples

10.5.5.1 Example1

Here is an example of a DescribeFeatureType request for the schema of the feature called station 1 used in the previous examples. ?xml version=1.0 encoding=UTF-8? DescribeFeatureType xmlns = http:www.opengis.netsos1.0 xmlns:xsi = http:www.w3.org2001XMLSchema-instance xsi:schemaLocation = http:www.opengis.netsos1.0 http:schemas.opengis.netsos1.0.0sosAll.xsd service = SOS version = 1.0.0 FeatureId urn:MyOrg:feature:station1 FeatureId DescribeFeatureType The response would be the schema for Station which might look like this: ?xml version=1.0 encoding=UTF-8? schema xmlns:gml = http:www.opengis.netgml xmlns:gmd = http:www.isotc211.org2005gmd xmlns:swe = http:www.opengis.netswe1.0.1 xmlns:om = http:www.opengis.netom1.0 xmlns = http:www.w3.org2001XMLSchema xmlns:sa = http:www.opengis.netsampling1.0 targetNamespace = http:www.opengis.netsampling1.0.0 elementFormDefault = qualified attributeFormDefault = unqualified version = 1.0.0 . . . complexType name = StationType annotation documentation A Station is an identified position 0-D geospatial feature. It may be revisited for various purposes, in particular to retrieve multiple specimens or make repeated or complementary observations. The position property of the station provides the value of the position property of observations an specimens associated with the station. By using the Station feature, this position information and any metadata associated with it may be encoded in one place, i.e. normalised, and then re-used _by reference_ on other feature instances associated with it. documentation annotation complexContent extension base = sa:SamplingFeatureType sequence element name = position type = gml:PointPropertyType element name = elevation type = gml:DirectPositionType minOccurs = annotation documentation Use the srsName attribute to record the elevation datum documentation annotation element sequence extension complexContent complexType -- .................. -- element name = Station type = sa:StationType substitutionGroup = sa:SamplingFeature . . . schema Copyright © 2007 Open Geospatial Consortium, Inc. All Rights Reserved. 49

10.6 DescribeObservationType optional