ST_AsText

ST_AsText
Prev	8.9.1. 知名文本(WKT)	Next

Name

ST_AsText — 返回不带SRID元数据的几何图形/地理图形的知名文本(WKT)表示。

Synopsis

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)几何图形/地理图形的表示。可选的 最大小数位数 参数可用于限制输出纵坐标中小数点后的位数(默认为15)。

要执行从WKT制图表达到PostGIS几何的逆转换，请使用 ST_GeomFromText 。


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


	WKT中数字的文本表示可能不会保持完全的浮点精度。为确保数据存储或传输的完全准确性，最好使用知名的二进制 (WKB)格式(请参阅 ST_AsBinary 和 `最大小数位数` )。


	使用 `最大小数位数` 参数可能会导致输出几何图形无效。为了避免这种使用 ST_ReducePrecision 首先要有一个合适的网格大小。

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

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

This method implements the OGC Simple Features Implementation Specification for SQL 1.1. s2.1.1.1

This method implements the SQL/MM specification. SQL-MM 3：5.1.25

This method supports Circular Strings and Curves

示例

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)

这个 最大小数位数 参数可用于限制输出精度。

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

另请参阅

ST_AsBinary , ST_AsEWKB , ST_AsEWKT , ST_GeomFromText