Compartir por


STUnion (tipo de datos geometry)

Se aplica a: SQL Server Azure SQL Database Azure SQL Managed Instance

Devuelve un objeto que representa la unión de una instancia de geometry con otra instancia de geometry.

Sintaxis

  
.STUnion ( other_geometry )  

Nota:

Para ver la sintaxis de Transact-SQL para SQL Server 2014 (12.x) y versiones anteriores, consulte Versiones anteriores de la documentación.

Argumentos

other_geometry
Es otra instancia de geometry para formar la unión con la instancia en la que se invoca STUnion().

Tipos de valor devuelto

Tipo de valor devuelto de SQL Server: geometry

Tipo de valor devuelto de CLR: SqlGeometry

Observaciones

Este método siempre devuelve NULL si no coinciden los identificadores de referencia espacial (SRID) de las instancias de geometry. El resultado puede contener segmentos de arco circulares solo si las instancias de entrada contienen segmentos de arco circulares.

Ejemplos

A. Calcular la unión de dos instancias de Polygon

En el ejemplo siguiente se usa STUnion() para calcular la unión de dos instancias de Polygon.

DECLARE @g geometry;  
DECLARE @h geometry;  
SET @g = geometry::STGeomFromText('POLYGON((0 0, 0 2, 2 2, 2 0, 0 0))', 0);  
SET @h = geometry::STGeomFromText('POLYGON((1 1, 3 1, 3 3, 1 3, 1 1))', 0);  
SELECT @g.STUnion(@h).ToString();  

B. Calcular la unión de una instancia de Polygon con una instancia de CurvePolygon

En el siguiente ejemplo se devuelve una instancia de GeometryCollection que contiene un segmento de arco circular.

 DECLARE @g geometry = 'CURVEPOLYGON(CIRCULARSTRING(0 -4, 4 0, 0 4, -4 0, 0 -4))';  
 DECLARE @h geometry = 'POLYGON((5 -1, 5 -3, 7 -3, 7 -1, 5 -1))';  
 SELECT @g.STUnion(@h).ToString();

STUnion() devuelve un resultado que contiene un segmento de arco circular porque la instancia que invocó STUnion() contiene un segmento de arco circular.

Consulte también

Métodos de OGC en instancias de geometry