ST_AsText
上一页  7.9.1. 众所周知的文本 (WKT)  下一页

名称

ST_AsText — 返回不包含 SRID 元数据的几何/地理的众所周知的文本 (WKT) 表示。

概要

text ST_AsText(geometry g1);

text ST_AsText(geometry g1, integer maxdecimaldigits = 15);

text ST_AsText(geography g1);

text ST_AsText(geography g1, integer maxdecimaldigits = 15);

描述

返回几何/地理的 OGC 众所周知的文本 (WKT) 表示。 可选的 maxdecimaldigits 参数可用于限制输出坐标中小数点后的位数（默认为 15）。

要执行 WKT 表示到 PostGIS 几何的逆转换，请使用 ST_GeomFromText。

[Note]

标准的 OGC WKT 表示不包含 SRID。 要将 SRID 作为输出表示的一部分包含进来，请使用非标准的 PostGIS 函数 ST_AsEWKT
[Warning]

WKT 中数字的文本表示可能无法保持完整的浮点精度。 为确保数据存储或传输的完整精度，最好使用 众所周知的二进制 (WKB) 格式（请参阅 ST_AsBinary 和 maxdecimaldigits）。
[Warning]

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

可用性：1.5 - 引入了对地理的支持。

增强功能：2.5 - 引入了可选参数精度。

此方法实现了OGC 简单要素 SQL 实现规范 1.1。 s2.1.1.1

此方法实现了 SQL/MM 规范。 SQL-MM 3：5.1.25

此方法支持圆弧字符串和曲线。

示例

SELECT ST_AsText('01030000000100000005000000000000000000
000000000000000000000000000000000000000000000000
F03F000000000000F03F000000000000F03F000000000000F03
F000000000000000000000000000000000000000000000000');

    st_astext
--------------------------------
 POLYGON((0 0,0 1,1 1,1 0,0 0))

默认输出为全精度。

SELECT ST_AsText('POINT(111.1111111 1.1111111)'));
    st_astext
------------------------------
 POINT(111.1111111 1.1111111)

可以使用 maxdecimaldigits 参数来限制输出精度。

SELECT ST_AsText('POINT(111.1111111 1.1111111)'), 2);
    st_astext
--------------------
 POINT(111.11 1.11)