Compartilhar via


STArea (tipo de dados geometry)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureBanco de Dados SQL no Microsoft Fabric

A função STArea retorna a área de uma instância de geometria em unidades quadradas, com base no SRID (identificador de referência espacial) da geometria.

Sintaxe

.STArea ( )

Tipos de retorno

Tipo de retorno do SQL Server: float

Tipo de retorno do CLR: SqlDouble

Comentários

STArea() retornará 0 se uma instância de geometria contiver apenas figuras unidimensionais e unidimensionais ou se estiver vazia. retornará se a instância de geometria não tiver sido inicializada.

Exemplos

a. Computando a área de uma instância de Polígono

O exemplo a seguir cria uma instância de Polygon``geometry e calcula a área do 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. Computando a área de uma instância de CurvePolygon

O exemplo a seguir calcula a área de uma instância 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;