ST_AsText
上一個  7.9.1. 已知文本 (WKT)  下一個

名稱

ST_AsText — 傳回幾何/地理的已知文本 (WKT) 表示，不包含 SRID 元數據。

概要

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)