STArea (tipo de dados geometry)

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure

Retorna uma área de superfície total de uma instância de geometry.

Sintaxe

  
.STArea ( )  

Observação

Para exibir a sintaxe do Transact-SQL para o SQL Server 2014 (12.x) e versões anteriores, confira a Documentação das versões anteriores.

Tipos de retorno

Tipo de retorno do SQL Server: float

Tipo de retorno do CLR: SqlDouble

Comentários

STArea() retorna 0 se uma instância de geometry contém apenas valores dimensionais 0- e 1- ou se ela está vazia. STArea() retorna NULL se a instância de geometry não foi 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;

Consulte Também

Métodos OGC em instâncias geometry