STUnion (tipo de dados geography)
Retorna um objeto que representa a união de uma instância de geography com outra instância de geography.
Sintaxe
.STUnion ( other_geography )
Argumentos
- other_geography
É outra instância de geography para formar uma união com a instância na qual STUnion() está sendo invocado.
Tipos de retorno
SQL Server tipo de retorno: geography
Tipo de retorno CLR: SqlGeography
Exceções
Esse método gerará uma ArgumentException se a instância contiver uma borda oposta.
Comentários
Esse método sempre retornará nulo se os SRIDs (IDs de referência espacial) das instâncias de geography não forem correspondentes.
SQL Server oferece suporte a instâncias espaciais maiores do que um hemisfério. No SQL Server, o conjunto de possíveis resultados retornado no servidor foi estendido a instâncias de FullGlobe.
O resultado poderá conter segmentos de arco circular apenas se as instâncias de entrada contiverem segmentos de arco circulares.
Esse método não é preciso.
Exemplos
A.Calculando a união de dois polígonos
O exemplo a seguir usa STUnion() para computar a união de duas instâncias de Polygon.
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 de FullGlobe
O exemplo a seguir gera um FullGlobe quando STUnion() combina duas instâncias de Polygon.
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 orifício triagonal de uma união de um CurvePolygon e um orifício triagonal.
O exemplo a seguir gera um orifício triagonal da união de um CurvePolygon com uma instância de Polygon.
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();