STUnion (tipo de dados geometry)

Aplica-se a: SQL Server (todas as versões com suporte) Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure

Retorna um objeto que representa a união de uma instância de geometry com outra instância de geometry.

Sintaxe

  
.STUnion ( other_geometry )  

Observação

Para ver a sintaxe do Transact-SQL para o SQL Server 2014 e versões anteriores, confira a Documentação das versões anteriores.

Argumentos

other_geometry
É outra instância de geometry para formar uma união com a instância na qual STUnion() está sendo invocado.

Tipos de retorno

Tipo de retorno do SQL Server: geometry

Tipo de retorno do CLR: SqlGeometry

Comentários

Esse método sempre retornará nulo se as SRIDs (IDs de referência espacial) das instâncias de geometry não forem correspondentes. O resultado poderá conter segmentos de arco circular apenas se as instâncias de entrada contiverem segmentos de arco circulares.

Exemplos

a. Calculando a união de duas instâncias Polygon

O exemplo a seguir usa STUnion() para computar a união de duas instâncias 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. Calculando a união de uma instância Polygon com uma instância de CurvePolygon

O exemplo a seguir retorna uma instância de GeometryCollection que contém um 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() retorna um resultado que contém um segmento de arco circular porque a instância que invocou STUnion() contém um segmento de arco circular.

Consulte Também

Métodos OGC em instâncias geometry