説明

TopoGeometryのGML表現を、GML 3形式で返します。nsprefix_inが指定されていない場合はgmlが使われます。非指定名前空間を得るためにnsprefixには空文字列が渡されます。precision(精度, デフォルト: 15)とoption(デフォルト: 1)パラメータは、与えられた場合は、この関数が使用するST_AsGMLにそのまま渡ります。

visitedTableパラメータは、与えられた場合は、重複定義でなく相互参照(xlink:xref)を使うために、訪問したノード要素とエッジ要素の追跡を保持するために使われます。 最善の効率のために、element_typeとelement_idに、この順序でインデクスを作成するべきです。 このインデクスは、一意性制約をフィールドに与えると自動的に生成されます。たとえば次のようになります。

CREATE TABLE visited (
  element_type integer, element_id integer,
  unique(element_type, element_id)
);

idprefixパラメータは、与えられた場合は、EdgeタグとNodeタグの識別子に前置されます。

gmlverパラメータは、与えられた場合は、この関数が使用するST_AsGMLに渡ります。デフォルトは3です。

初出: 2.0.0

例

本例ではCreateTopoGeomで生成したTopoGeometryを使います。

SELECT topology.AsGML(topo) As rdgml 
  FROM ri.roads 
  WHERE road_name = 'Unknown';
  
-- rdgml--
<gml:TopoCurve>
    <gml:directedEdge>
        <gml:Edge gml:id="E1">
            <gml:directedNode orientation="-">
                <gml:Node gml:id="N1"/>
            </gml:directedNode>
            <gml:directedNode></gml:directedNode>
            <gml:curveProperty>
                <gml:Curve srsName="urn:ogc:def:crs:EPSG::3438">
                    <gml:segments>
                        <gml:LineStringSegment>
                            <gml:posList srsDimension="2">384744 236928 384750 236923 384769 236911 384799 236895 384811 236890 
                            384833 236884 384844 236882 384866 236881 384879 236883 384954 236898 385087 236932 385117 236938 
                            385167 236938 385203 236941 385224 236946 385233 236950 385241 236956 385254 236971 
                            385260 236979 385268 236999 385273 237018 385273 237037 385271 237047 385267 237057 385225 237125 
                            385210 237144 385192 237161 385167 237192 385162 237202 385159 237214 385159 237227 385162 237241 
                            385166 237256 385196 237324 385209 237345 385234 237375 385237 237383 385238 237399 385236 237407 
                            385227 237419 385213 237430 385193 237439 385174 237451 385170 237455 385169 237460 385171 237475 
                            385181 237503 385190 237521 385200 237533 385206 237538 385213 237541 385221 237542 385235 237540 385242 237541 
                            385249 237544 385260 237555 385270 237570 385289 237584 385292 237589 385291 237596 385284 237630</gml:posList>
                        </gml:LineStringSegment>
                    </gml:segments>
                </gml:Curve>
            </gml:curveProperty>
        </gml:Edge>
    </gml:directedEdge>
</gml:TopoCurve>		

Same exercise as previous without namespace

SELECT topology.AsGML(topo,'') As rdgml 
  FROM ri.roads 
  WHERE road_name = 'Unknown';
  
-- rdgml--
<TopoCurve>
    <directedEdge>
        <Edge id="E1">
            <directedNode orientation="-">
                <Node id="N1"/>
            </directedNode>
            <directedNode></directedNode>
            <curveProperty>
                <Curve srsName="urn:ogc:def:crs:EPSG::3438">
                    <segments>
                        <LineStringSegment>
                            <posList srsDimension="2">384744 236928 384750 236923 384769 236911 384799 236895 384811 236890 
                            384833 236884 384844 236882 384866 236881 384879 236883 384954 236898 385087 236932 385117 236938 
                            385167 236938 385203 236941 385224 236946 385233 236950 385241 236956 385254 236971 
                            385260 236979 385268 236999 385273 237018 385273 237037 385271 237047 385267 237057 385225 237125 
                            385210 237144 385192 237161 385167 237192 385162 237202 385159 237214 385159 237227 385162 237241 
                            385166 237256 385196 237324 385209 237345 385234 237375 385237 237383 385238 237399 385236 237407 
                            385227 237419 385213 237430 385193 237439 385174 237451 385170 237455 385169 237460 385171 237475 
                            385181 237503 385190 237521 385200 237533 385206 237538 385213 237541 385221 237542 385235 237540 385242 237541 
                            385249 237544 385260 237555 385270 237570 385289 237584 385292 237589 385291 237596 385284 237630</posList>
                         </LineStringSegment>
                    </segments>
                </Curve>
            </curveProperty>
        </Edge>
    </directedEdge>
</TopoCurve>		

関連情報

CreateTopoGeom, ST_CreateTopoGeo