ST_AsText 方法

geometry-expression.ST_AsText([ format])

名称	类型	说明
format	VARCHAR(128)	定义将 geometry-expression 转换为文本表示时使用的输出文本格式的字符串。如果未指定，则使用 st_geometry_astext_format 选项选择文本表示。请参见st_geometry_astext_format 选项。

LONG VARCHAR 返回 geometry-expression 的文本表示。

ST_AsText 方法返回表示几何的文本字符串。支持许多不同的文本格式（及其关联选项），使用可选 format 参数选择所需格式。如果未指定 format 参数，则使用 st_geometry_astext_format 选项选择要使用的输出格式。请参见st_geometry_astext_format 选项。

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

format-name

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

parameter1=value1;parameter2=value2;...

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

可能使用以下格式名称：

WKT 由 SQL/MM 和 OGC 定义的标准文本格式。
EWKT 扩展标准文本格式。此格式包括几何的 SRID 作为前缀。
GML 由 ISO 19136 和 OGC 定义的地理标记语言格式。
KML 由 OGC 定义的 Keyhole 标记语言格式。
GeoJSON GeoJSON 格式使用 http://geojson.org/geojson-spec.html 中定义的 JavaScript Object Notation (JSON)。
SVG 由万维网联盟（World Wide Web Consortium，简称 W3C）定义的可缩放矢量图形（Scalable Vector Graphics，简称 SVG）1.1 格式。

可以指定以下格式参数：

格式名称	参数名称	缺省值	允许值	说明
WKT	Version	1.2	1.1 由 OGC SFS 1.1 定义的 WKT。此格式不包含 Z 和 M 值。如果几何包含 Z 或 M 值，在输出中将移除这些值。 1.2 由 OGC SFS 1.2 定义的 WKT。应用于 2D 数据时此格式与版本 1.1 格式匹配，并扩展版本 1.1 格式以支持 Z 和 M 值。 PostGIS 一些其他供应商使用的 WKT 格式，包括 Z 和 M 值，但格式与 OGC 1.2 不匹配。	Version 参数控制所使用的 WKT 规范的版本。
GML	Version	3	2 GML 规范版本 2。 3 GML 规范版本 3.2。	Version 参数控制所使用的 GML 规范的版本。
GML	Namespace	none	local 为给定元素（在本例中为点）及其子元素提供缺省命名空间属性。 global 为给定元素及其子元素提供专用前缀 ("gml")。在集合操作中使用查询时此参数值很有用，通过此参数值某些顶级元素可以定义 "gml" 前缀的命名空间。 none 不为给定元素（在本例中为点）及其子元素提供命名空间或前缀。	Namespace 参数可指定命名空间的输出格式约定。
GML	SRSNameFormat	short	short 使用空间参照系名称的短格式，例如 EPSG:4326。 long 使用空间参照系名称的长格式，例如 urn:x-ogc:def:crs:EPSG:4326。 none 几何不包括空间参照系名称属性。	SRSNameFormat 参数指定 srsName 属性的格式。
GML	SRSDimension	No	Yes 或 No	SRSDimension 参数指定给定几何的坐标值数。此参数仅适用于 GML(version=3)。
GML	SRSFillAll	No	Yes 或 No	SRSFillAll 参数指定是否将 SRS 属性传播到子几何元素。例如，MultiGeometry 或 MultiPolygon 会将属性传播到子几何。
GML	UseDeprecated	No	Yes 或 No	UseDeprecated 参数仅适用于 GML(version=3)。使用此参数时，只要可能就输出更早的 GML 表示。例如，如果几何中不包含 CircularString，则可以将 Surface 输出为 Polygon。
GML	Attribute	自动生成的可选属性	仅可以为顶级几何元素指定一个或多个属性。	可以指定任何合法的 XML 属性。
GML	SubElement	自动生成的 GML 子元素	仅可以为顶级几何元素指定一个或多个子元素。	可以指定任何合法的 XML 元素。
KML	Version	2	2	支持 KML 2.2 版本。
KML	Attribute	自动生成的可选属性	仅可以为顶级几何元素指定一个或多个属性。	可以指定任何合法的 XML 属性。
KML	Namespace	No	local 为给定几何元素（在本例中为点）及其子元素提供缺省命名空间属性 http://www.opengis.net/kml/2.2。 global 为给定元素及其子元素提供专用前缀 ("kml")。在集合操作中使用查询时此参数值很有用，通过此参数值某些顶级元素可以定义 "kml" 前缀的命名空间。 none 不为给定元素（在本例中为点）及其子元素提供命名空间或前缀。	Namespace 参数可指定命名空间的输出格式约定。
KML	SubElement	自动生成的 KML 子元素	仅可以为顶级几何元素指定一个或多个子元素。	可以指定任何合法的 XML 元素。例如，可以指定 extrude、tessellate 和 altitudeMode 元素。
GeoJSON	Version	1	1	所遵守的 GeoJSON 规范的版本。目前仅支持 1.0 版本。
SVG	Approximate	Yes	Yes 或 No	Approximate 参数可指定是否通过略微减少显示的详细信息来减小输出 SVG 文档的大小。可通过不包含位于最后一个点的线宽范围内的点来计算 SVG 数据的近似值。在几何多达几兆字节时使用此参数会获得 80% 或以上的压缩率。
SVG	Attribute	自动生成的可选属性	可应用于 SVG 形状元素的一个或多个 SVG 属性	缺省情况下会生成 fill、stroke 和 stroke-width 等可选 SVG 形状属性。如果已指定 Attribute 参数，则不生成任何可选 SVG 形状属性，而是使用 Attribute 值。如果指定了 PathDataOnly=Yes，则此参数将被忽略。Attribute 值的最大长度为约 1000 个字节。
SVG	DecimalDigits	基于空间参照系的“对齐网格”网格大小中的小数位数。最大缺省值为 5，最小缺省值为 0。	整数	DecimalDigits 参数可限制在 SVG 输出中生成的坐标的小数点后面的位数。将位数指定为负值表示 SVG 输出应包含坐标的完整精度。
SVG	PathDataOnly	No（生成完整的 SVG 文档）	Yes 或 No	PathDataOnly 参数可指定是否应只生成 SVG 路径元素的数据。下面的 PathDataOnly 示例中演示了如何使用 PathDataOnly=Yes 建立可以显示的完整 SVG 文档。缺省情况下会生成一个完整的 SVG 文档。由 PathDataOnly=Yes 返回的路径数据可用于构建更加灵活且包含其它元素（如文本）的 SVG 文档。
SVG	RandomFill	Yes	Yes 或 No	RandomFill 参数可指定是否应使用随机生成的颜色填充多边形。使用颜色时不遵循明确定义的顺序，且通常在每次生成 SVG 输出时发生变化。No 表示只绘制每个多边形的轮廓。如果指定了 Attribute 或 PathDataOnly=Yes 参数，则将忽略 RandomFill 参数。
SVG	Relative	Yes	Yes 或 No	Relative 参数可指定坐标应以相对（偏移）格式输出还是绝对格式输出。相对坐标数据通常比绝对坐标数据更精简。

注意

将几何值转换为 VARCHAR 或 NVARCHAR 时，服务器使用 ST_AsText 方法。使用 st_geometry_astext_format 选项定义转换时所使用的格式。请参见st_geometry_astext_format 选项。

注意

缺省情况下，如果几何的原始格式可用，ST_AsText 将使用该格式。否则使用内部格式。有关内部和原始格式的详细信息，请参见STORAGE FORMAT 子句，CREATE SPATIAL REFERENCE SYSTEM 语句。

SQL/MM (ISO/IEC 13249-3: 2006) 5.1.35

假设 st_geometry_astext_format 选项具有值 'WKT'，以下示例会返回结果 Point ZM (1 2 3 4)。请参见st_geometry_astext_format 选项。

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

假设 st_geometry_astext_format 选项具有值 'WKT'，以下示例会返回结果 Point ZM (1 2 3 4)。将几何转换为 VARCHAR 或 NVARCHAR 类型时，隐式调用 ST_AsText 方法。请参见st_geometry_astext_format 选项。

SELECT CAST( NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ) as long varchar)

以下示例返回结果 [Point (1 2)]。因为 WKT 的 OGC 规范 1.1.0 版本不支持 Z 和 M 值，所以不输出这两个值。

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AsText('WKT(Version=1.1)')

以下示例返回结果 [SRID=4326;Point ZM (1 2 3 4)]。结果中包括 SRID 作为前缀。

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AsText('EWKT')

以下示例返回结果 <Point srsName="EPSG:4326"><pos>1 2 3 4</pos></Point>。

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AsText('GML')

以下示例返回 ['{"type":"Point", "coordinates":[1,2]} ']。

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AsText('GeoJSON')

以下示例返回多边形以随机颜色填充的完整 SVG 文档。

SELECT NEW ST_Polygon( 'Polygon(( 0 0, 0 20, 60 10, 0 0 ))' )
		    .ST_AsText( 'SVG' )

ST_AsText 方法

语法

参数

返回值

注释

注意

注意

另请参见

标准和兼容性

示例