Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
Collapse the table of content
Expand the table of content
Expand Minimize

STUnion (geometry Data Type)


Applies To: SQL Server 2014, SQL Server 2016 Preview

Returns an object that represents the union of a geometry instance with another geometry instance.

Applies to: SQL Server (SQL Server 2012 through current version), Azure SQL Database.

.STUnion ( other_geometry )


Is another geometry instance to form a union with the instance on which STUnion() is being invoked.

SQL Server return type: geometry

CLR return type: SqlGeometry

This method always returns null if the spatial reference IDs (SRIDs) of the geometry instances do not match. The result may contain circular arc segments only if the input instances contain circular arc segments.

The following example uses STUnion() to compute the union of two Polygon instances.

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();

The following example returns a GeometryCollection instance that contains a circular arc segment.

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() returns a result that contains a circular arc segment because the instance that invoked STUnion() contains a circular arc segment.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

© 2015 Microsoft