STArea (tipo de dados geometry)

  • Artigo

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzurePonto de extremidade de análises SQL no Microsoft FabricWarehouse no Microsoft Fabric

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