名称

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]

要求 PostGIS 在编译时支持 Proj。使用 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_AsSVG, ST_AsGML