STArea (tipo de dados geography)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do Azure

Retorna a área total da superfície de uma instância de geography. Resultados para STArea() são a unidade de medida quadrada usada pelo identificador de referência espacial da instância geography. Por exemplo, se o SRID da instância for 4326, STArea() retornará resultados em metros quadrados.

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() retornará 0 se uma instância de geography contiver apenas figuras sem dimensões ou unidimensionais, ou se estiver vazia.

Observação

Os métodos com o tipo de dados geography que geram um valor retornado métrico terão resultados diferentes com base na SRID da instância usada no método. Para obter mais informações sobre SRIDs, confira SRIDs (Identificadores de Referência Espacial).

Exemplos

O exemplo a seguir usa STArea() para criar uma instância de Polygon geography e calcula a área do polígono.

DECLARE @g geography;  
SET @g = geography::STGeomFromText('POLYGON((-122.358 47.653, -122.348 47.649, -122.348 47.658, -122.358 47.658, -122.358 47.653))', 4326);  
SELECT @g.STArea();  

Consulte Também

Métodos do OGC em instâncias de geography