名前

ST_AsText — ジオメトリ/ジオグラフィのSRIDメタデータのないWell-Known Text (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);

説明

ジオメトリ/ジオグラフィのWell-Knownテキスト表現を返します。任意引数は、出力で使われる小数点以下の最大桁数を減らすのに使えます。

[注記]

WKT仕様ではSRIDは入りません。SRIDを持つOGC WKTの書式を得るには、OGC標準ではないPostGIS ST_AsEWKTを使用します。

[警告]

WKT書式は精度はあまり維持しませんので、浮動小数点数の打ち切りをさせないために、ST_AsBinaryかST_AsEWKB書式を使用して運んで下さい。

[注記]

ST_AsTextはST_GeomFromTextの逆です。ST_AsText表現をPostGISジオメトリに変換するにはST_GeomFromTextを使います。

Availability: 1.5 - ジオグラフィ対応が導入されました。

Enhanced: 2.5 - 精度の任意引数が導入されました。

This method implements the OpenGIS 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))
(1 row)

精度の提供は任意です。

SELECT ST_AsText(GeomFromEWKT('SRID=4326;POINT(111.1111111 1.1111111)'))
          st_astext
------------------------------
 POINT(111.1111111 1.1111111)
(1 row)
SELECT ST_AsText(GeomFromEWKT('SRID=4326;POINT(111.1111111 1.1111111)'),2)
st_astext
--------------------
POINT(111.11 1.11)
(1 row)

関連情報

ST_AsBinary, ST_AsEWKB, ST_AsEWKT, ST_GeomFromText