STArea (tipo de datos geometry)

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstancePunto de conexión de análisis SQL en Microsoft FabricAlmacenamiento en Microsoft Fabric

Devuelve el área expuesta total de una instancia de geometry.

Sintaxis

  
.STArea ( )  

Nota:

Para ver la sintaxis de Transact-SQL para SQL Server 2014 (12.x) y versiones anteriores, consulte Versiones anteriores de la documentación.

Tipos de valor devuelto

Tipo de valor devuelto de SQL Server: float

Tipo de valor devuelto de CLR: SqlDouble

Comentarios

STArea() devuelve 0 si una instancia de geometry contiene únicamente figuras no dimensionales o unidimensionales, o si está vacía. STArea() devuelve NULL si la instancia de geometry no se ha inicializado.

Ejemplos

A. Calcular el área de una instancia de Polygon

En el siguiente ejemplo se crea una instancia de Polygon``geometry y se calcula el área del polígono.

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. Calcular el área de una instancia de CurvePolygon

En el siguiente ejemplo se calcula el área de una instancia de CurvePolygon.

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

Consulte también

Métodos de OGC en instancias de geometry