ジオメトリまたはジオグラフィオブジェクトの Well-Known Text(WKT)表現を返します。出力には空間参照識別子(SRID)のメタデータは含まれません。
WKT 文字列をジオメトリオブジェクトに再解析するには、ST_GeomFromText を使用します。
構文
text ST_AsText(geometry g1);
text ST_AsText(geometry g1 , integer maxdecimaldigits);
text ST_AsText(geography g1);
text ST_AsText(geography g1 , integer maxdecimaldigits);パラメーター
| パラメーター | 説明 |
|---|---|
g1 | WKT に変換するジオメトリまたはジオグラフィオブジェクトです。 |
maxdecimaldigits | 出力における小数点以下の最大桁数です。デフォルト値: 15。 |
注意事項
返される WKT 文字列には SRID は含まれません。出力に SRID のメタデータを含める場合は、「ST_AsEWKT」をご参照ください。
警告
WKT では浮動小数点の精度が保証されません。ストレージまたはトランスポート時に完全な精度を保持するには、「ST_AsBinary」または「ST_AsEWKB」をご利用ください。
例
デフォルト精度を使用
SELECT ST_AsText(ST_GeomFromText('POINT(116 40)',4326)); st_astext
---------------
POINT(116 40)
(1 row)小数点以下の桁数を制限
maxdecimaldigits に値を指定すると、座標が指定された小数点以下の桁数に四捨五入されます。
SELECT ST_AsText(ST_GeomFromText('POINT(116.112 40.412)',4326),2); st_astext
---------------------
POINT(116.11 40.41)
(1 row)次のステップ
「ST_AsEWKT」 — SRID メタデータ付きの WKT を返します
「ST_AsBinary」 — SRID を含まない WKB を返します
「ST_AsEWKB」 — SRID を含む WKB を返します