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.
Sintaxe
.STArea ( )
Tipos de retorno
Tipo de retorno do SQL Server: floatfloat
Tipo de retorno CLR: SqlDoubleSqlDouble
Comentários
STArea() retornará 0 se uma instância geography contiver apenas valores dimensionais 0 - e 1- ou se estiver vazio.
.gif "Observação") Observação |
|---|
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 Polygongeography 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();