ST_Multi

ST_Multi は、ジオメトリを対応するマルチタイプに変換します。入力ジオメトリがすでにマルチタイプまたはジオメトリコレクションである場合は、そのコピーが返されます。入力ジオメトリがポイント、ライン文字列、またはポリゴンである場合、入力ジオメトリを含むマルチポイント、マルチライン文字列、またはマルチポリゴンがそれぞれ返されます。

構文

ST_Multi(geom)

引数

geom

データ型 GEOMETRY の値または GEOMETRY 型と評価される式の値。

戻り型

サブタイプ MULTIPOINT、MULTILINESTRING、MULTIPOLYGON、または GEOMETRYCOLLECTION の GEOMETRY。

返されるジオメトリの空間参照系識別子 (SRID) の値は、入力ジオメトリのものと同じです。

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

例

次の SQL は、入力マルチポイントからマルチポイントを返します。

SELECT ST_AsEWKT(ST_Multi(ST_GeomFromText('MULTIPOINT((1 2),(3 4))', 4326)));

    st_asewkt
------------------------------------
  SRID=4326;MULTIPOINT((1 2),(3 4))             

次の SQL は、入力ポイントからマルチポイントを返します。

SELECT ST_AsEWKT(ST_Multi(ST_GeomFromText('POINT(1 2)', 4326)));

    st_asewkt
------------------------------------
  SRID=4326;MULTIPOINT((1 2))             

次の SQL は、入力ジオメトリからジオメトリコレクションを返します。

SELECT ST_AsEWKT(ST_Multi(ST_GeomFromText('GEOMETRYCOLLECTION(POINT(1 2),MULTIPOINT((1 2),(3 4)))', 4326)));

    st_asewkt
------------------------------------
  SRID=4326;GEOMETRYCOLLECTION(POINT(1 2),MULTIPOINT((1 2),(3 4)))