ST_GeomFromEWKT
ST_GeomFromEWKT は、入力ジオメトリの拡張 well-known text (EWKT) 表現からジオメトリオブジェクトを構築します。
ST_GeomFromEWKT は、3DZ、3DM、および 4D を受け入れます。この場合、各ジオメトリタイプの先頭には Z、M、または ZM がプレフィックスされます。
構文
ST_GeomFromEWKT(ewkt_string)
引数
- ewkt_string
-
データ型
VARCHAR
の値、またはVARCHAR
型に評価される式、つまりジオメトリの EWKT 表現。WKT キーワード
EMPTY
を使用すると、空のポイント、空のポイントを持つマルチポイント、あるいは空のポイントを持つジオメトリコレクションを指定することができます。次の例では、空のポイントを 1 つ作成します。ST_GeomFromEWKT('SRID=4326;POINT EMPTY');
戻り型
GEOMETRY
ewkt_string が null の場合、null が返されます。
ewkt_string が有効でない場合、エラーが返されます。
例
次の SQL は、EWKT 値からマルチライン文字列を作成し、ジオメトリを返します。また、ジオメトリの ST_AsEWKT 結果を返します。
SELECT ST_GeomFromEWKT('SRID=4326;MULTILINESTRING((1 0,1 0),(2 0,3 0),(4 0,5 0,6 0))') as geom, ST_AsEWKT(geom);
geom | st_asewkt
------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------
0105000020E610000003000000010200000002000000000000000000F03F0000000000000000000000000000F03F00000000000000000102000000020000000000000000000040000000000000000000000000000008400000000000000000010200000003000000000000000000104000000000000000000000000000001440000000000000000000000000000018400000000000000000 | SRID=4326;MULTILINESTRING((1 0,1 0),(2 0,3 0),(4 0,5 0,6 0))