名称

ST_AsKML — 以 KML 元素的形式返回几何图形。

语法

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 确认您已编译 Proj 支持。

[Note]

可用性:1.2.2 - 包含版本参数的后续变体在 1.3.2 中出现

[Note]

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

[Note]

已更改:3.0.0 - 已移除“版本化”变体签名

[Note]

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

此函数支持 3d,并且不会删除 z 索引。

示例

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_AsSVGST_AsGML