Name

ST_AsKML — 将几何图形作为 KML 元素返回。

Synopsis

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

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

描述

将几何图形作为 Keyhole 标记语言 (KML) 元素返回。 默认最大小数位数为 15,默认命名空间无前缀。

[Warning]

使用 maxdecimaldigits 参数可能会导致输出几何图形无效。 为了避免这种情况,首先使用 ST_ReducePrecision 和合适的网格大小。

[Note]

需要在 Proj 支持下编译 PostGIS。 使用 PostGIS_Full_Version确认您已编译项目支持。

[Note]

可用性:1.2.2 - 包含版本参数的更高版本出现在 1.3.2 中

[Note]

增强:2.0.0 - 添加前缀命名空间,使用默认和命名参数

[Note]

更改:3.0.0 - 删除了“版本化”变体签名

[Note]

AsKML 输出不适用于没有 SRID 的几何图形

该函数支持 3d 并且不会丢失 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