説明

ジオメトリー/ジオグラフィのWell-Known Text (WKT) 表現を返します。任意引数maxdecimaldigitsは、出力で使われる小数点以下の最大桁数を制限するのに使います (デフォルトは15)。

ＷKT 表現を PostGIS ジオメトリーに逆変換するにはST_GeomFromTextを使います。

	標準の OGC WKT 表現は SRID を含みません。出力表現に SRID を持たせるには、非標準のPostGIS 関数ST_AsEWKTを使います。

	WKT における数字の文字表現では、完全な浮動小数点数の精度を維持しないことがあります。データ保存や転送で完全な精度を得るにはWell-Known Binary (WKB) 書式を使用するのが最善です (ST_AsBinaryおよびmaxdecimaldigitsをご覧下さい)。

	任意引数maxdecimaldigitsを使用することで、出力ジオメトリが不正になる可能性があります。これを回避するには、前もってST_ReducePrecisionに適切なグリッドサイズを与えてこれを使用します。

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

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

このメソッドはOGC Simple Features Implementation Specification for SQL 1.1の実装です。 s2.1.1.1

このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.25

このメソッドは曲線ストリングと曲線に対応しています。

例

SELECT ST_AsText('01030000000100000005000000000000000000000000000000000000000000000000000000000000000000f03f000000000000f03f000000000000f03f000000000000f03f000000000000000000000000000000000000000000000000');

POLYGON((0 0,0 1,1 1,1 0,0 0))

図

完全な出力制度がデフォルトです。

SELECT ST_AsText('POINT(111.1111111 1.1111111)'::geometry);

POINT(111.1111111 1.1111111)

引数maxdecimaldigitsは、出力精度の制限に使います。

SELECT ST_AsText('POINT(111.1111111 1.1111111)'::geometry, 2);

POINT(111.11 1.11)

関連情報

ST_AsBinary, ST_AsEWKB, ST_AsEWKT, ST_GeomFromText