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