ST_Union
ST_Union devuelve una geometría que representa la unión de dos geometrías. Es decir, fusiona las geometrías de entrada para producir una geometría resultante sin superposiciones.
Sintaxis
ST_Union(geom1, geom2)
Argumentos
- geom1
-
Un valor de tipo de datos
GEOMETRY
o una expresión que toma el valor de un tipoGEOMETRY
. - geom2
-
Un valor de tipo de datos
GEOMETRY
o una expresión que toma el valor de un tipoGEOMETRY
.
Tipo de retorno
GEOMETRY
El valor del identificador de sistema de referencia espacial (SRID) de la geometría devuelta es el valor SRID de las geometrías de entrada de datos.
Si geom1 o geom2 son null, entonces se devuelve el valor null.
Si geom1 o geom2 están vacíos, se devuelve una geometría vacía.
Si geom1 y geom2 no tienen el mismo valor en el identificador de sistema de referencia espacial (SRID), se devuelve un error.
Si geom1 o geom2 son una recopilación geométrica, cadena de líneas o cadenas de líneas múltiples, se devuelve un error.
Si geom1 o geom2 no es una geometría bidimensional (2D), entonces se devuelve un error.
Ejemplos
El siguiente SQL devuelve la geometría que no está vacía y representa la unión entre dos geometrías de entrada.
SELECT ST_AsEWKT(ST_Union(ST_GeomFromText('POLYGON((0 0,100 100,0 200,0 0))'), ST_GeomFromText('POLYGON((0 0,10 0,0 10,0 0))')));
st_asewkt
-------------------------
POLYGON((0 0,0 200,100 100,5 5,10 0,0 0))