このトピックでは、ST_GeomCollFromText関数について説明します。 この関数は、Well-Known Text (WKT) 文字列と空間参照識別子 (SRID) を使用してGeometryCollectionオブジェクトを作成します。
構文
geometry ST_GeomCollFromText(text WKT , integer srid);
geometry ST_GeomCollFromText(text WKT);パラメーター
パラメーター | 説明 |
WKT | 指定するWKT文字列。 |
srid | GeometryCollectionオブジェクトのSRID。 |
説明
SRIDを指定しない場合、デフォルトのSRID 0が使用されます。
指定したWKT文字列がGeometryCollectionオブジェクトを表していない場合、この関数はエラーを返します。
指定したWKT文字列がGeometryCollectionオブジェクトを表していることを確認できない場合は、この関数を使用しないでください。 この関数は、追加の検証ステップを必要とする。 その結果、この関数はST_GeomFromText関数よりも低速でジオメトリオブジェクトを構築します。
例
SELECT ST_AsText(ST_GeomCollFromText('GEOMETRYCOLLECTION(POINT(1 2),LINESTRING(3 4, 5 6))'));
st_astext
----------------------------------------------------
GEOMETRYCOLLECTION(POINT(1 2),LINESTRING(3 4,5 6))
(1 row)