| title | STArea (geometry Data Type) | ||
|---|---|---|---|
| description | STArea (geometry Data Type) | ||
| author | MladjoA | ||
| ms.author | mlandzic | ||
| ms.reviewer | maghan | ||
| ms.date | 12/27/2024 | ||
| ms.service | sql | ||
| ms.subservice | t-sql | ||
| ms.topic | reference | ||
| ms.custom |
|
||
| f1_keywords |
|
||
| helpviewer_keywords |
|
||
| dev_langs |
|
||
| monikerRange | =azuresqldb-current || >=sql-server-2016 || >=sql-server-linux-2017 || =azuresqldb-mi-current || =fabric-sqldb |
[!INCLUDE SQL Server Azure SQL Database Azure SQL Managed Instance FabricSQLDB]
The STArea function returns the area of a geometry instance in square units, based on the spatial reference identifier (SRID) of the geometry.
.STArea ( )
[!INCLUDE ssNoVersion] return type: float
CLR return type: SqlDouble
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.
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();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;