Edit

Share via

STArea (geometry data type)

  • Article

Applies to: SQL Server Azure SQL Database Azure SQL Managed Instance SQL database in Microsoft Fabric

The STArea function returns the area of a geometry instance in square units, based on the spatial reference identifier (SRID) of the geometry.

Syntax

.STArea ( )

Return Types

SQL Server return type: float

CLR return type: SqlDouble

Remarks

STArea() returns 0 if a geometry instance contains only 0-dimensional and 1-dimensional figures, or if it's empty. STArea() returns NULL if the geometry instance hasn't been initialized.

Examples

A. Computing the area of a Polygon instance

The following example creates a Polygon``geometry instance and computes the area of the polygon.

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

B. Computing the area of a CurvePolygon instance

The following example computes the area of a CurvePolygon instance.

 DECLARE @g geometry;
 SET @g = geometry::Parse('CURVEPOLYGON(CIRCULARSTRING(0 2, 2 0, 4 2, 4 2, 0 2))');
 SELECT @g.STArea() AS Area;

Related content