ST_Multi
ST_Multi convierte la geometría en el multitipo correspondiente. Si la geometría de entrada ya es un multitipo o una colección de geometría, se devuelve una copia de ella. Si la geometría de entrada es un punto, una cadena de línea o un polígono, se devuelve un multipunto, una cadena de varias líneas o un multipolígono, respectivamente, que contiene la geometría de entrada.
Sintaxis
ST_Multi(geom)
Argumentos
- geom
-
Un valor de tipo de datos
GEOMETRY
o una expresión que toma el valor de un tipoGEOMETRY
.
Tipo de retorno
GEOMETRY
con subtipo MULTIPOINT
, MULTILINESTRING
, MULTIPOLYGON
o GEOMETRYCOLLECTION
.
El identificador del sistema de referencia espacial (SRID) de la geometría devuelta es el mismo que el de la geometría de entrada.
Si geom es nulo, entonces se devuelve el valor nulo.
Ejemplos
El siguiente SQL devuelve un multipunto a partir de un multipunto de entrada.
SELECT ST_AsEWKT(ST_Multi(ST_GeomFromText('MULTIPOINT((1 2),(3 4))', 4326)));
st_asewkt
------------------------------------
SRID=4326;MULTIPOINT((1 2),(3 4))
El siguiente SQL devuelve un multipunto a partir de un punto de entrada.
SELECT ST_AsEWKT(ST_Multi(ST_GeomFromText('POINT(1 2)', 4326)));
st_asewkt
------------------------------------
SRID=4326;MULTIPOINT((1 2))
El siguiente SQL devuelve una colección de geometría a partir de una colección de geometría 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)))