ST_GeomFromText

ST_GeomFromText は、入力ジオメトリの WKT (Well-Known Text) 表現からジオメトリオブジェクトを作成します。

ST_GeomFromText は、(ジオメトリタイプに Z、M、または ZM がプレフィックスされた) 3DZ、3DM、および 4D を受け入れます。

構文

ST_GeomFromText(wkt_string)

ST_GeomFromText(wkt_string, srid)

引数

wkt_string

ジオメトリの WKT 表現であるデータ型 VARCHAR の値。

WKT キーワード EMPTY を使用すると、空のポイント、空のポイントを持つマルチポイント、あるいは空のポイントを持つジオメトリコレクションを指定することができます。次の例では、空のポイントと空でないポイントを、それぞれ1 つ持つマルチポイントを作成します。

ST_GeomFromEWKT('MULTIPOINT(1 0,EMPTY)');

srid

空間リファレンス識別子 (SRID) であるデータ型 INTEGER の値。SRID 値が指定されている場合、返されたジオメトリはこの SRID 値を持ちます。指定されていない場合は、返されるジオメトリの SRID 値は 0 に設定されます。

戻り型

GEOMETRY

wkt_string または srid が null の場合、null が返されます。

srid が負数の場合、null が返されます。

wkt_string が有効でない場合、エラーが返されます。

srid が有効でない場合、エラーが返されます。

例

次の SQL は、WKT 表現と SRID 値からジオメトリオブジェクトを作成します。

SELECT ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326);

st_geomfromtext
--------------------------------
0103000020E61000000100000005000000000000000000000000000000000000000000000000000000000000000000F03F000000000000F03F000000000000F03F000000000000F03F000000000000000000000000000000000000000000000000