geometry-expression.ST_AsKML([ format])

ST_AsKML 方法返回表示几何的 KML 字符串。支持许多不同的格式（及其关联选项），使用可选 format 参数选择所需格式。如果未指定 format 参数，缺省值是 'KML'。

格式字符串定义输出格式和格式参数。格式字符串具有以下格式之一：

format-name

format-name(parameter1=value1;parameter2=value2;...)

parameter1=value1;parameter2=value2;...

第一种格式指定格式名称，但不指定格式参数。所有格式参数均使用缺省值。第二种格式指定格式名称以及指定参数值列表。未提供参数值的参数使用缺省值。最后一种格式仅指定参数值，格式名称缺省为 'KML'。

可能使用以下格式名称：

可以指定以下格式参数：

以下示例返回结果 <Point><coordinates>1,2,3,4</coordinates></Point>。

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AsKML()

以下示例返回结果 [<Point><coordinates>1,2,3,4</coordinates></Point>]。

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AsKML('KML(Version=2)')

以下示例返回结果 [<kml:Point><kml:coordinates>1,2,3,4</kml:coordinates></kml:Point>]。Namespace=global 参数为给定元素及其子元素提供专用前缀 ("kml")。在集合操作中使用查询时此参数值很有用，通过此参数值某些顶级元素可以定义 "kml" 前缀的命名空间。

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AsKML('KML(Version=2;Namespace=global)')

以下示例返回结果 [<Point><coordinates>1,2,3,4</coordinates></Point>]。输出中不包含命名空间信息。

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AsKML('KML(Version=2;Namespace=none)')

以下示例返回结果 [<Point xmlns="http://www.opengis.net/kml/2.2"><coordinates>1,2,3,4</coordinates></Point>]。使用缺省 xml 命名空间。

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AsKML('KML(Version=2;Namespace=default)')

以下示例返回结果 [<Point><altitudeMode>absolute</altitudeMode><coordinates>1,2,3,4</coordinates></Point>]。输出中包括 AltitudeMode 子元素。

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AsKML('SubElement=<altitudeMode>absolute</altitudeMode>')