ST_Union

ST_Union retorna uma geometria que representa a união de duas geometrias. Ou seja, as geometrias de entrada são mescladas para produzir uma geometria sem sobreposições.

Sintaxe

ST_Union(geom1, geom2)

Argumentos

geom1

Um valor de tipo de dados GEOMETRY ou uma expressão que é avaliada como um tipo GEOMETRY.

geom2

Um valor de tipo de dados GEOMETRY ou uma expressão que é avaliada como um tipo GEOMETRY.

Tipo de retorno

GEOMETRY

O valor do identificador do sistema de referência espacial (SRID - spatial reference system identifier) da geometria retornada é o valor do SRID das geometrias de entrada.

Nulo será retornado se geom1 ou geom2 for nulo.

Se geom1 e geom2 estiverem vazios, será retornada uma geometria vazia.

Um erro será retornado se geom1 e geom2 não tiverem o mesmo valor do identificador do sistema referência espacial (SRID -spatial reference system identifier).

Se geom1 ou geom2 for um conjunto de geometrias, linestring ou multilinestring, será retornado um erro.

Se geom1 ou geom2 não forem uma geometria bidimensional (2D), será retornado um erro.

Exemplos

O SQL a seguir retorna a geometria não vazia que representa a união de duas geometrias 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))