Edit

STConvexHull (geometry Data Type)

  • Article

Applies to: SQL Server Azure SQL Database Azure SQL Managed Instance SQL analytics endpoint in Microsoft Fabric Warehouse in Microsoft Fabric

Returns an object representing the convex hull of a geometry instance.

Syntax

  
.STConvexHull ( )

Note

To view Transact-SQL syntax for SQL Server 2014 (12.x) and earlier versions, see Previous versions documentation.

Return Types

SQL Server return type: geometry

CLR return type: SqlGeometry

Remarks

STConvexHull() returns the smallest convex polygon that contains the given geometry instance. Points or co-linear LineString instances will produce an instance of the same type as that of the input.

Examples

The following example uses STConvexHull() to find the convex hull of a non-convex Polygon``geometry instance.

DECLARE @g geometry;  
SET @g = geometry::STGeomFromText('POLYGON((0 0, 0 2, 1 1, 2 2, 2 0, 0 0))', 0);  
SELECT @g.STConvexHull().ToString();

See Also

OGC Methods on Geometry Instances