STUnion (tipo de dados geográficos)

Aplica-se a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceBase de dados SQL no Microsoft Fabric

Retorna um objeto que representa a união de uma ocorrência de geografia com outra ocorrência de geografia .

Syntax

  
.STUnion ( other_geography )  

Arguments

other_geography
É outra instância geográfica para formar uma união com a instância na qual STUnion() está sendo invocado.

Tipos de devolução

Tipo de retorno do SQL Server: geografia

Tipo de retorno CLR: SqlGeography

Exceptions

Esse método lança um ArgumentException se a instância contém uma borda antipodal.

Remarks

Esse método sempre retorna null se os identificadores de referência espacial (SRIDs) das instâncias geográficas não corresponderem.

O SQL Server dá suporte a instâncias espaciais maiores que um hemisfério. No SQL Server, o conjunto de possíveis resultados retornados no servidor foi estendido para instâncias FullGlobe .

O resultado pode conter segmentos de arco circular somente se as instâncias de entrada contiverem segmentos de arco circular.

Este método não é preciso.

Examples

A. Computando a união de dois polígonos

O exemplo a seguir usa STUnion() para calcular a união de duas Polygon instâncias.

SQL

DECLARE @g geography;  
DECLARE @h geography;  
SET @g = geography::STGeomFromText('POLYGON((-122.358 47.653, -122.348 47.649, -122.348 47.658, -122.358 47.658, -122.358 47.653))', 4326);  
SET @h = geography::STGeomFromText('POLYGON((-122.351 47.656, -122.341 47.656, -122.341 47.661, -122.351 47.661, -122.351 47.656))', 4326);  
SELECT @g.STUnion(@h).ToString();  

B. Produzindo um resultado FullGlobe

O exemplo a seguir produz um FullGlobe quando STUnion() combina duas Polygon instâncias.

SQL

 DECLARE @g geography = 'POLYGON ((-122.358 47.653, -122.358 47.658,-122.348 47.658, -122.348 47.649, -122.358 47.653))';  
 DECLARE @h geography = 'POLYGON ((-122.358 47.653, -122.348 47.649, -122.348 47.658, -122.358 47.658, -122.358 47.653))';  
 SELECT @g.STUnion(@h).ToString();

C. Produzindo um buraco triagonal a partir de uma união de um CurvePolygon e um buraco triagonal.

O exemplo a seguir produz um buraco triagonal a partir da união de um CurvePolygon com uma Polygon instância.

SQL

 DECLARE @g geography = 'POLYGON ((-0.5 0, 0 1, 0.5 0.5, -0.5 0))';  
 DECLARE @h geography = 'CURVEPOLYGON(COMPOUNDCURVE(CIRCULARSTRING(0 0, 0.7 0.7, 0 1), (0 1, 0 0)))';  
 SELECT @g.STUnion(@h).ToString();

Ver também

Métodos OGC em instâncias geográficas