STArea (tipo de dados geography)
Retorna a área da superfície total de uma instância geography. Os resultados de STArea() são retornados no quadrado da unidade de medida 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.
Aplica-se a: SQL Server (SQL Server 2008 até a versão atual), Banco de dados SQL do Windows Azure (versão inicial até a versão atual). |
Sintaxe
.STArea ( )
Tipos de retorno
SQL Server tipo de retorno: float
tipo de retorno CLR: SqlDouble
Comentários
STArea() retornará 0 se uma instância geography contiver apenas valores de 0 e 1 dimensão ou se estiver vazio.
Dica
Métodos com o tipo de dados geography que produzem um valor de retorno métrico terão resultados diferentes com base na SRID da instância usada no método.Para obter mais informações sobre SRIDs, consulte SRIDs (Spatial Reference Identifiers).
Exemplos
O exemplo a seguir usa STArea() para criar uma instância Polygon geography e calcular 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();