ST_Union

ST_Union renvoie une géométrie représentant l’union de deux géométries. C’est-à-dire qu’il fusionne les géométries en entrée pour produire une géométrie résultante sans chevauchement.

Syntaxe

ST_Union(geom1, geom2)

Arguments

geom1

Valeur de type de données GEOMETRY ou expression qui est évaluée sur un type GEOMETRY.

geom2

Valeur de type de données GEOMETRY ou expression qui est évaluée sur un type GEOMETRY.

Type de retour

GEOMETRY

La valeur de l’identifiant de système de référence spatiale (SRID) de la géométrie renvoyée est la valeur SRID des géométries d’entrée.

Si geom1 ou geom2 est null, null est renvoyé.

Si geom1 ou geom2 est vide, une géométrie vide est renvoyée.

Si geom1 et geom2 n’ont pas la même valeur pour l’identifiant de système de référence spatiale (SRID), une erreur est renvoyée.

Si geom1 ou geom2 est une collection géométrique, une linestring ou une multilinestring, une erreur est renvoyée.

Si geom1 ou geom2 n’est pas une géométrie bidimensionnelle (2D), une erreur est renvoyée.

Exemples

Le code SQL suivant renvoie la géométrie non vide représentant l’intersection de deux géométries en entrée.

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