Bounding box Vendor-specific parameters

OpenGIS © Specification OGC 04-094 Copyright © Open Geospatial Consortium, Inc 2005 96 14.4 Common parameters The following table describes parameters common to all WFS requests. Subsequent tables may redefine some of the facets of one or more of the parameters in this table. Table 7 – Common parameters for WFS requests URL Component OM 4 DEFAULT Description http:server_addresspathscript M URL prefix of web feature service VERSION M 5 1.1.0 Request version. SERVICE M WFS Service type. REQUEST M Name of WFS request. NAMESPACE O Used to specify a namespace and its prefix. The format must be xmlnsprefix=escaped_url where escaped_url is defined in [17]. If the prefix is not specified then this is the default namespace. More that one namespace may be bound by specifying a comma seperated list of xmlns values. Additional parameters As described in this section. Vendor-specific parameters O Optional vendor specific parameters. The mandatory VERSION parameter specifies the protocol version number and allows for negotiation as described in subclause 6.2.4. The mandatory SERVICE parameter specifies which of the available service types at a particular service instance is being invoked. The value WFS is used to indicate that the Web Feature Service should be invoked. The parameter REQUEST must also be included and it indicates which of the web feature service operations to invoke. The possible values of the REQUEST parameters are: DescribeFeatureType, LockFeature, Transaction, GetFeature, GetFeatureWithLock or GetCapabilities. The optional parameter NAMESPACE is included to support qualified feature and property names such as myns:InWaterA_1M where the prefix myns must be bound to a particular namespace. The format of the parameter values is: xmlnsprefix=EscapedNamespaceName where EscapedNamespaceName is the escaped url of the namespace and is defined in [17]. The prefix may be omitted to denote the default namespace. The NAMESPACE 4 O = Optional, M=Mandatory 5 VERSION is mandatory for all operations except the GetCapabilities operation. OpenGIS © Specification OGC 04-094 Copyright © Open Geospatial Consortium, Inc 2005 97 parameter may contain a comma separated list of xmlns values in order to bind all the namespaces being referenced in a KVP encoded request. Additional GET parameters, as described in this section, shall be expressed as name- value pairs. Parameter names shall not be case sensitive. Parameter values shall be case sensitive. Parameters in a request may be specified in any order. A WFS must be prepared to encounter parameters that are not part of the specification. These are known as vendor-specific parameters. Vendor-specific parameters allow vendors to specify additional parameters that will enhance the results of requests. A WFS must produce valid results even if the vendor-specific parameters are missing or malformed. A WFS may declare vendor-specific parameters within its capabilities XML. A WFS may choose to advertise some or all of its vendor specific parameters. Clients may read the capabilities schema and formulate requests using any vendor-specific parameters advertised therein.

14.5 Response

The response to any request encoded using keyword-value pair encoding shall be identical to the responses generated for requests encoded in XML and described in earlier sections of this document.

14.6 Exceptions

Exception reporting for requests encoded using keyword-value pairs shall be identical to that generated by requests encoded using XML. Refer to cub clauses 7.7 and 11.4 for a detailed discussion of exception reporting. 14.7 Operations 14.7.1 Introduction This section describes how to formulate WFS requests using standard CGI style keyword-value pair encoding. Heavy use is made of examples that illustrate the various forms possible. In addition, for clarity, each parameter specification in the examples is placed on a separate line.

14.7.2 DescribeFeatureType operation

14.7.2.1 Request

Table 8 – DescribeFeatureType encoding URL Component OM DEFAULT Description REQUEST=DescribeFeatureType M Name of request. OpenGIS © Specification OGC 04-094 Copyright © Open Geospatial Consortium, Inc 2005 98 TYPENAME O A comma separated list of feature types to describe. If no value is specified that is to be interpreted as all feature types. OUTPUTFORMAT O textxml; subtype=gml3.1.1 The output format to use to describe feature types. textxml; subtype=gml3.1.1 must be supported. Other output formats, such as DTD are possible.

14.7.2.2 Examples Example 1

The following example requests the schema description of the feature type TreesA_1M. http:www.someserver.comwfs.cgi? SERVICE=WFS VERSION=1.1.0 REQUEST=DescribeFeatureType TYPENAME=TreesA_1M Example 2 The following example requests the schema description of the feature types InWaterA_1M and BuiltUpA_1M. http:www.someserver.comwfs.cgi? SERVICE=WFS VERSION=1.1.0 REQUEST=DescribeFeatureType TYPENAME=TreesA_1M,BuiltUpA_1M 14.7.3 GetFeature GetFeatureWithLock operation 14.7.3.1 Request Table 9a – GetFeature GetFeatureWithLock encoding URL Component OM DEFAULT Description REQUEST=[GetFeature | GetFeatureWithLock] M The name of the WFS request. OUTPUTFORMAT O textxml; subtype=gml3.1.1 The output format to use for the response. textxml; subtype=gml3.1.1 must be supported. Other output formats are possible as well as long as their MIME type is advertised in the capabilities document.