설명

TopoGeometry의 GML 표현식을 GML3 버전 서식으로 반환합니다. nsprefix_in 을 따로 설정하지 않을 경우 gml 접두사를 이용합니다. nsprefix에 대해 텅 빈 문자열을 넘겨줄 경우 무자격(non-qualified) 네임스페이스를 반환합니다. 정확도(기본값 15) 및 옵션(기본값 1) 파라미터를 설정한 경우, 손대는 일 없이 ST_AsGML 함수에 대한 기저 호출에 그대로 넘겨줍니다.

visitedTable 파라미터는 접근한 노드 및 경계선 요소를 추적하는 데 쓰이기 때문에, 설정할 경우, 정의를 복제하는 게 아니라 교차 참조(xlink:xref)를 이용합니다. 정수형 항목 'element_type' 및 'element_id' (적어도) 2개가 테이블에 있어야 합니다. 함수 호출자는 입력 테이블에 대해 읽기 및 쓰기 권한을 가지고 있어야만 합니다. 최상의 성능을 내려면, element_type 과 element_id 에, 이 순서대로, 인덱스를 정의해야 합니다. 항목들에 유일한 제약조건을 추가하면 이 인덱스를 자동적으로 생성할 것입니다. 다음은 그 예시입니다:

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

idprefix 파라미터를 설정할 경우, 노드 및 경계선 태그 식별자에 접두사를 붙일 것입니다.

gmlver 파라미터를 설정할 경우, 기저 ST_AsGML 함수에 해당 파라미터를 넘겨줄 것입니다. 기본값은 3입니다.

2.0.0 버전부터 사용할 수 있습니다.

예시

다음 예시는 CreateTopoGeom 에서 생성한 지형 도형을 사용합니다.

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
>

이전 예시와 동일하지만 네임스페이스를 쓰지 않습니다.

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