STArea (tipo de dados geography)
Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Banco de Dados SQL no Microsoft Fabric
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 ( )
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();