STArea (тип данных geography)

Применимо к:SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure

Возвращает общую площадь поверхности экземпляра geography. Результаты для метода STArea() возвращаются в виде квадрата единицы измерения, используемой идентификатором пространственной ссылки экземпляра geography. Например, если SRID экземпляра равен 4326, то метод STArea() возвращает результаты в квадратных метрах.

Синтаксис

  
.STArea ( )  

Примечание.

Сведения о синтаксисе Transact-SQL для SQL Server 2014 (12.x) и более ранних версиях см . в документации по предыдущим версиям.

Типы возвращаемых данных

Тип возвращаемого значения SQL Server: float

Тип возвращаемых данных CLR: SqlDouble

Замечания

Метод STArea() возвращает значение 0, если экземпляр geography содержит только объекты размерности 0 и 1 либо является пустым.

Примечание.

Методы, вызываемые для типа данных geography и возвращающие метрическое значение, могут возвращать различные результаты в зависимости от идентификатора SRID экземпляра. Дополнительные сведения об идентификаторах SRID см. в разделе Идентификаторы пространственных ссылок (SRID).

Примеры

В следующем примере используется метод STArea() для создания экземпляра Polygon geography и вычисляется площадь этого многоугольника.

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();  

См. также

Методы OGC в экземплярах Geography