説明

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

WKT 表現を 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