OpenGIS
©
Specification OGC 04-094
Copyright © Open Geospatial Consortium, Inc 2005
53
textxml; subtype=gml3.1.1. This will indicate that a WFS must generate a GML document fragment of the result set that conforms to the OpenGIS
Geography Markup Language Implementation Specification, version 3.1.1 [2].
The response to a GetGmlObject request is the referenced GML element returned as an XML document fragment. This differs from the response to a GetFeature request,
which returns a complete document containing a wfs:FeatureCollection.
If the content of the response to a GetGmlObject request contains nested property XLink linking element locator attribute href XLinks, the content of the response is affected by
the value of the traverseXlinkDepth and traverseXlinkExpiry attributes of the GetGmlObject request, which control how the response element is rewritten to include
the elements referenced by the XLinks. If any such nested property XLink linking element locator attribute value references a remote WFS, the response content is also
affected by whether the local WFS has the capability to respond to a remote GetGmlObject requests.
10.4 Exceptions
In the event that a web feature service encounters an error servicing a GetGmlObject request, it shall raise an exception as described in subclause 7.7.
10.5 Examples
This section contains numerous examples of the GetGmlObject request. Some examples include sample output.
Example 1
This example shows a GetGmlObject request element that fetches the feature with the identifier InWaterA_1M.1234.
?xml version=1.0 encoding=UTF-8? wfs:GetGmlObject
xmlns:wfs=http:www.opengis.netwfs xmlns:ogc=http:www.opengis.netogc
xmlns:gml=http:www.opengis.netgml xmlns:xsi=http:www.w3.org2001XMLSchema-instance
xsi:schemaLocation=http:www.opengis.netwfs ..wfs1.1.0WFS.xsd service=WFS
version=1.1.0 outputFormat=textxml; subtype=gml3.1.1
traverseXlinkDepth=1 traverseXlinkExpiry=1
ogc:GmlObjectId gml:id=InWaterA_1M.1234[Simon Cox3] wfs:GetGmlObject
Example 2
This example shows a GetGmlObject request element that fetches the feature with the identifier “t1” without performing any nested XLink traversal:
?xml version=1.0 encoding=UTF-8?
OpenGIS
©
Specification OGC 04-094
Copyright © Open Geospatial Consortium, Inc 2005
54
wfs:GetGmlObject xmlns:wfs=http:www.opengis.netwfs
xmlns:ogc=http:www.opengis.netogc xmlns:gml=http:www.opengis.netgml
xmlns:xsi=http:www.w3.org2001XMLSchema-instance
xsi:schemaLocation=http:www.opengis.netwfs ..wfs1.1.0WFS.xsd service=WFS
version=1.1.0 outputFormat=textxml; subtype=gml3.1.1
traverseXlinkDepth=1 traverseXlinkExpiry=1
ogc:GmlObjectId gml:id=t1 wfs:GetGmlObject
and the response:
Town gml:id=t1 gml:nameBedfordgml:name
gml:directedNode orientation=+ xlink:href=n1 Town
Example 3
This example is the same as example 2 except that it requests nested XLink traversal at depth 2:
?xml version=1.0 encoding=UTF-8? wfs:GetGmlObject
xmlns:wfs=http:www.opengis.netwfs xmlns:ogc=http:www.opengis.netogc
xmlns:gml=http:www.opengis.netgml xmlns:xsi=http:www.w3.org2001XMLSchema-instance
xsi:schemaLocation=http:www.opengis.netwfs ..wfs1.1.0WFS.xsd service=WFS
version=1.1.0 outputFormat=textxml; subtype=gml3.1.1
traverseXlinkDepth=2 traverseXlinkExpiry=1
ogc:GmlObjectId gml:id=t1 wfs:GetGmlObject
and the response:
Town gml:id=t1 gml:nameBedfordgml:name
gml:directedNode orientation=+ -- xlink:href=n1 gml:Node gml:id=”n1”
gml:pointProperty xlink:href=”http:www.bedford.town.ukcivilworksgps.gmltownHall”
gml:Node gml:directedNode
Town
Example 4
This example is the same as example 3 except that it requests unlimited nested XLink traversal from a WFS that has a remote GetGmlObject capability:
?xml version=1.0 encoding=UTF-8? wfs:GetGmlObject
xmlns:wfs=http:www.opengis.netwfs xmlns:ogc=http:www.opengis.netogc
xmlns:gml=http:www.opengis.netgml xmlns:xsi=http:www.w3.org2001XMLSchema-instance
xsi:schemaLocation=http:www.opengis.netwfs ..wfs1.1.0WFS.xsd