STUnion (тип данных geometry)

Область применения: yesSQL Server (все поддерживаемые версии) YesБаза данных SQL Azure YesУправляемый экземпляр SQL Azure

Возвращает объект, представляющий объединение экземпляра geometry с другим экземпляром geometry.

Синтаксис

  
.STUnion ( other_geometry )  

Примечание

Ссылки на описание синтаксиса Transact-SQL для SQL Server 2014 и более ранних версий, см. в статье Документация по предыдущим версиям.

Аргументы

other_geometry
Другой экземпляр geometry, образующий объединение с экземпляром, для которого вызван метод STUnion().

Типы возвращаемых данных

Тип возвращаемых данных SQL Server: geometry

Тип возвращаемых данных CLR: SqlGeometry

Комментарии

Этот метод всегда возвращает значение NULL, если у экземпляров geometry не совпадают идентификаторы пространственных ссылок (SRID). Результат может содержать сегменты дуги, только если во входном экземпляре содержатся сегменты дуги.

Примеры

A. Вычисление объединения двух экземпляров многоугольников

В следующем примере метод STUnion() производит объединение двух экземпляров 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();  

Б. Вычисление объединения экземпляра Polygon с экземпляром CurvePolygon

Следующий пример возвращает экземпляр GeometryCollection, содержащий сегмент дуги.

 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() возвращает результат, содержащий сегмент дуги, так как экземпляр, вызвавший STUnion(), содержит сегмент дуги.

См. также

Методы OGC в экземплярах Geometry