D.11KVP examples D.11.1Conventions In general, URL-encoding requires that certain characters, such as '&', be escaped (see IETF RFC 2396) when they are not used in their intended manner. In this section, however, such characters are not be escaped for the sake of clarity. In addition, many of the examples in this section include a FILTER parameter whose value is an XML encoded filter as specified in ISO 19143. To be rigorously correct, these examples should include namespace and schema location information in the root element , such that the XML may be validated. Thus the parameter: FILTER=InWaterA_1M/wkbGeom 10 1020 20 should more correctly be specified as: FILTER= InWaterA_1M/wkbGeom 10 10 20,20 In order to not obfuscate the essential information, however, the namespace and schema location attribute tags have been omitted from the examples in this section. In addition, the schema locations shown are only example locations and the correct schema locations would need to be substituted. Finally, the values of the FILTER and other parameters are broken up over several lines again for clarities sake. A FILTER parameter's value, in practice, would be composed of a single long string. D.11.2DescribeFeatureType examples Example 1 The following example requests the schema description of the feature type TreesA_1M. http://www.someserver.example.com/wfs.cgi? SERVICE=WFS& VERSION=2.0.0& NAMESPACE=xmlns(myns=http://www.myserver.com/myns) REQUEST=DescribeFeatureType& TYPENAMES=myns:TreesA_1M Example 2 The following example requests the schema description of the feature types InWaterA_1M and BuiltUpA_1M. http://www.someserver.example.com/wfs.cgi? SERVICE=WFS& VERSION=2.0.0& NAMESPACE=xmlns(ns1=http://www.someserver.example.com/ns1),xmlns(ns2= http://someserver.example.com/ns2)& REQUEST=DescribeFeatureType& TYPENAMES=ns1:TreesA_1M,ns2:BuiltUpA_1M D.11.3GetFeature and GetFeatureWithLock examples Many of the examples in this section include a FILTER parameter whose value is an XML encoded filter as specified in ISO 19143. To be rigorously correct, these examples should include namespace and schema location information in the root element , such that the XML may be validated. Thus the parameter: FILTER=InWaterA_1M/wkbGeom 10 10 20 20 should more correctly be: FILTER= InWaterA_1M/wkbGeom 10 10 20 20 For the sake of clarify, however, the namespace and schema location attribute tags have been omitted from the examples in this section. In addition, the schema locations shown are only example locations and the correct schema locations would need to be specified. Finally, the value of the FILTER parameter is broken up over several lines again for clarities sake. An actual FILTER parameter would have a single long string as its argument. Example 1 Query all properties of all instances of type InWaterA_1M. http://www.someserver.example.com/wfs.cgi& SERVICE=WFS& VERSION=2.0.0& REQUEST=GetFeature& TYPENAMES=InWaterA_1M Example 2 Query some properties of all instances of type InWaterA_1M. http://www.someserver.example.com/wfs.cgi& SERVICE=WFS& VERSION=2.0.0& REQUEST=GetFeature& TYPENAMES=InWaterA_1M& PROPERTYNAME=InWaterA_1M/wkbGeom,InWaterA_1M/tileId Example 3 Query all properties of the feature instance identified by the feature identifier "InWaterA_1M.1013". http://www.someserver.example.com/wfs.cgi& SERVICE=WFS& VERSION=2.0.0& REQUEST=GetFeature& RESOURCEID=InWaterA_1M.1013 Example 4 Query some properties of the feature instance identified by the feature identifier "InWaterA_1M.1013". http://www.someserver.example.com/wfs.cgi& SERVICE=WFS& VERSION=2.0.0& REQUEST=GetFeature& PROPERTYNAME=InWaterA_1M/wkbGeom,InWaterA_1M/tileId& RESOURCEID=InWaterA_1M.1013 Example 5 Query all properties of an enumerated set of feature instances of type InWaterA_1M. http://www.someserver.example.com/wfs.cgi& SERVICE=WFS& VERSION=2.0.0& REQUEST=GetFeature& RESOURCEID=InWaterA_1M.1013,InWaterA_1M.1014,InWaterA_1M.1015 Example 6 Query some properties of an enumerated set of feature instances of type InWaterA_1M. In this example, the wkbGeom and tileId properties are selected for each feature instance. http://www.someserver.example.com/wfs.cgi& SERVICE=WFS& VERSION=2.0.0& REQUEST=GetFeature& PROPERTYNAME=(InWaterA_1M/wkbGeom,InWaterA_1M/tileId) (InWaterA_1M/wkbGeom,InWaterA_1M/tileId) (InWaterA_1M/wkbGeom,InWaterA_1M/tileId)& RESOURCEID=InWaterA_1M.1013,InWaterA_1M.1014,InWaterA_1M.1015 Example 7 Query all properties of a constrained set of feature instances of type InWaterA_1M. http://www.someserver.example.com/wfs.cgi& SERVICE=WFS& VERSION=2.0.0& REQUEST=GetFeature& TYPENAMES=InWaterA_1M& FILTER=InWaterA_1M/wkbGeom 10 10 20 20 Example 8 Query some properties of a constrained set of features instances of type InWaterA_1M. http://www.someserver.example.com/wfs.cgi& SERVICE=WFS& VERSION=2.0.0& REQUEST=GetFeature& PROPERTYNAME=InWaterA_1M/wkbGeom,InWaterA_1M/tileId& TYPENAMES=InWaterA_1M& FILTER=InWaterA_1M/wkbGeom 10,10 20 20 Example 9 Query all properties of a list of feature types in different namespaces: http://www.someserver.example.com/wfs.cgi& SERVICE=WFS& VERSION=2.0.0& REQUEST=GetFeature& NAMESPACE=xmlns(myns=http://www.someserver.example.com), xmlns(yourns=http://www.someotherserver.com) TYPENAMES=myns:InWaterA_1M,your:BuiltUpA_1M Example 10 Query some properties of a list of feature types. In this case, the attributes wkbGeom and tileId are fetched for the InWaterA_1M feature type and all the attributes of feature type BuiltUpA_1M are fetched. http://www.someserver.example.com/wfs.cgi& SERVICE=WFS& VERSION=2.0.0& REQUEST=GetFeature& PROPERTY=(InWaterA_1M/wkbGeom,InWaterA_1M/tileId)(BuiltUpA_1M/*)& TYPENAMES=InWaterA_1M,BuiltUpA_1M Example 11 Query all properties of an enumerated set of feature instances. http://www.someserver.example.com/wfs.cgi& SERVICE=WFS& VERSION=2.0.0& REQUEST=GetFeature& RESOURCEID=InWaterA_1M.1013,BUILTUP_1M.3456 Example 12 Query some properties of an enumerated set of feature instances. In this case, the wkbGeom and tileId attributes are fetched for feature instance "InWaterA_1M.1013". The attribute wkbGeom is fetched for feature instance "BuiltUpA_1M.3456". http://www.someserver.example.com/wfs.cgi& SERVICE=WFS& VERSION=2.0.0& REQUEST=GetFeature& PROPERTYNAME=InWaterA_1M/wkbGeom,InWaterA_1M/tileId,BuiltUpA_1M/wkbGe om)& RESOURCEID=InWaterA_1M.1013,BuiltUpA_1M.3456 Example 13 Query all properties of all feature instances of the feature type InWaterA_1M and BuiltUpA_1M that lie within the specified box. http://www.someserver.example.com/wfs.cgi& SERVICE=WFS& VERSION=2.0.0& REQUEST=GetFeature& TYPENAMES=InWaterA_1M,BuiltUpA_1M& FILTER=(InWaterA_1M/wkbGeom 10 10 20 20 )( BuiltUpA_1M/wkbGeom10 10 20 20 ) Example 14 Query some properties of a constrained set of feature instances of types InWaterA_1M and BuiltUpA_1M. http://www.SiriusCyberneticsCorp.com/wfs.cgi& SERVICE=WFS& VERSION=2.0.0& REQUEST=GetFeature& PROPERTYNAME=(InWaterA_1M/wkbGeom,InWaterA_1MtileId)(BuiltUpA_1M/wkbG eom)& TYPENAMES=InWaterA_1M,BuiltUpA_1M& FILTER=(InWaterA_1M/wkbGeom|InWaterA_1M /wkbGeom 10 10 20,20 )( InWaterA_1M/wkbGeom10 10 20 20 ) Example 15 This example illustrates a GetFeature request using PROPERTYNAME components that serves as a base for comparison with Examples 16 and 17 . The request: http://www.someserver.example.com/wfs.cgi& SERVICE=WFS& VERSION=2.0.0& REQUEST=GetFeature& PROPERTYNAME=uk:Town/gml:name,uk:Town/gml:directedNode& RESOURCEID=t1 The response contains an xlink:href, but it is returned as-is: 10 10 20 20 Bedford Example 16 This example illustrates the use of the TRAVERSEXLINKDEPTH and TRAVERSEXLINKEXPIRY components on the GetFeature request from Example 15. The request: http://www.someserver.example.com/wfs.cgi& SERVICE=WFS& VERSION=2.0.0& REQUEST=GetFeature& PROPERTYNAME=uk:Town/gml:name,uk:Town/gml:directedNode& TRAVERSEXLINKDEPTH=1& EXPIRY=1& RESOURCEID=t1 In the response, the first level xlink:href has been traversed, and its contents returned as described for the GetGmlObject operation: 10 10 20 20 Bedford -47 34 D.11.4LockFeature examples Example 1 The following example locks all instances of feature type InWaterA_1M. http://www.someserver.example.com/wfs.cgi? SERVICE=WFS& VERSION=2.0.0& REQUEST=LockFeature& TYPENAMES=InWaterA_1M Example 2 The following example locks the feature identified by "RoadL_1M.1013". http://www.someserver.example.com/wfs.cgi? SERVICE=WFS& VERSION=2.0.0& REQUEST=LockFeature& RESOURCEID=RoadL_1M.1013 Example 3 The following example locks all feature instances of feature type InWaterA_1M and BuiltUpA_1M. http://www.someserver.example.com/wfs.cgi? SERVICE=WFS& VERSION=2.0.0& REQUEST=LockFeature& TYPENAMES=InWaterA_1M,BuiltUpA_1M Example 4 The following example locks all features of feature type InWaterA_1M and BuiltUpA_1M that lie INSIDE a user specified region of interest. http://www.someserver.example.com/wfs.cgi? SERVICE=WFS& VERSION=2.0.0& REQUEST=LockFeature& LOCKACTION=ALL& TYPENAMES=INWATER_1M,BuiltUpA_1M& FILTER=(wkbGeom 10 10 20 20 ) (wkbGeom 10 10 20 20 )