ST_AsKML
Prev  7.9.3. Other Formats  Next

Name

ST_AsKML — 도형을 GML 2 또는 GML 3 버전 요소로 반환합니다.

Synopsis

text ST_AsKML(geometry geom, integer maxdecimaldigits=15, text nprefix=NULL);

text ST_AsKML(geography geog, integer maxdecimaldigits=15, text nprefix=NULL);

설명

도형을 KML(Keyhole Markup Language) 요소로 반환합니다. 이 함수에는 몇 가지 변종이 있습니다. 출력물에 쓰이는 소수점 이하 자릿수의 최대값(기본값은 15), 버전의 기본값은 2이며 기본 네임스페이스는 접두사를 쓰지 않습니다.

[Warning]

Using the maxdecimaldigits parameter can cause output geometry to become invalid. To avoid this use ST_ReducePrecision with a suitable gridsize first.

[Note]

PostGIS를 Proj 지원과 함께 컴파일해야 합니다. Proj 지원과 함께 컴파일됐는지 여부를 확인하려면 PostGIS_Full_Version 을 이용하십시오.
[Note]

1.2.2 버전부터 사용할 수 있습니다. 버전 파라미터를 포함하는 최신 변종은 1.3.2 버전부터 등장했습니다.
[Note]

개선 사항: 2.0.0 버전부터 네임스페이스에 접두사를 추가할 수 있습니다. 기본값은 접두사를 쓰지 않는 것입니다.
[Note]

Changed: 3.0.0 - Removed the "versioned" variant signature
[Note]

ST_AsKML 출력물은 SRID가 없는 도형과는 동작하지 않을 것입니다.

This function supports 3d and will not drop the z-index.

예시

SELECT ST_AsKML(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326));

                st_askml
                --------
                <Polygon
><outerBoundaryIs
><LinearRing
><coordinates
>0,0 0,1 1,1 1,0 0,0</coordinates
></LinearRing
></outerBoundaryIs
></Polygon>

                --3d linestring
                SELECT ST_AsKML('SRID=4326;LINESTRING(1 2 3, 4 5 6)');
                <LineString
><coordinates
>1,2,3 4,5,6</coordinates
></LineString>

참고

ST_AsSVG, ST_AsGML