ST_Multi

ST_Multi converte uma geometria para o multitipo correspondente. Se a geometria de entrada já é um multitipo ou uma coleção de geometria, uma cópia dela é retornada. Se a geometria de entrada for ponto, uma linestring ou um polígono, será retornado um multiponto, um multipolígono ou um multipolígono, respectivamente, que contenha a geometria de entrada.

Sintaxe

ST_Multi(geom)

Argumentos

Tipo de retorno

GEOMETRY com subtipo MULTIPOINT, MULTILINESTRING, MULTIPOLYGON ou GEOMETRYCOLLECTION.

O Spatial Reference System Identifier (SRID – Identificador do sistema de referência espacial) da geometria retornada é o mesmo da geometria de entrada.

Nulo será retornado se geom for nulo.

Exemplos

O SQL a seguir retorna um multiponto de um multiponto de entrada.

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

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

O SQL a seguir retorna um multiponto de um ponto de entrada.

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

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

O SQL a seguir retorna uma coleção de geometria de uma coleção de geometria de entrada.

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)))