ST_AsText

ST_AsText は、入力されたジオメトリもしくはジオグラフィの WKT (Well-Known Text) 表現を返します。ジオメトリもしくはジオグラフィが 3DZ、3DM、および 4D の場合、ST_AsEWKT は、そのジオメトリもしくはジオグラフィのタイプを表す WKT 値に、Z、M、または ZM を追加します。

構文

ST_AsText(geo)

ST_AsText(geo, precision)

引数

geo

データ型 GEOMETRY または GEOGRAPHY の値、または GEOMETRY もしくは GEOGRAPHY 型として評価される式です。

precision

データ型 INTEGER の値。ジオメトリについての geo の座標は、1～20 で指定された精度を使用して表示されます。precision が指定されていない場合は、デフォルトは 15 です。ジオグラフィの場合、geom の座標は指定された精度を使用して表示されます。precision が指定されていない場合は、デフォルトは 15 です。

戻り型

VARCHAR

geo が null の場合、null が返されます。

precision が null の場合、null が返されます。

結果が 64-KB VARCHAR よりも大きい場合、エラーが返されます。

例

次の SQL は、LINESTRING の WKT 表現を返します。

SELECT ST_AsText(ST_GeomFromText('LINESTRING(3.141592653589793 -6.283185307179586,2.718281828459045 -1.414213562373095)', 4326));

st_astext
--------------------------------
LINESTRING(3.14159265358979 -6.28318530717959,2.71828182845905 -1.41421356237309)

次の SQL は、LINESTRING の WKT 表現を返します。ジオメトリの座標は 6 桁の精度で表示されます。

SELECT ST_AsText(ST_GeomFromText('LINESTRING(3.141592653589793 -6.283185307179586,2.718281828459045 -1.414213562373095)', 4326), 6);

st_astext
----------------------------------------------
 LINESTRING(3.14159 -6.28319,2.71828 -1.41421)

次の SQL は、ジオグラフィの WKT 表現を返します。

SELECT ST_AsText(ST_GeogFromText('LINESTRING(110 40, 2 3, -10 80, -7 9)'));

             st_astext
------------------------------------
 LINESTRING(110 40,2 3,-10 80,-7 9)