STArea (tipo de datos geography)

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

Devuelve el área expuesta total de una instancia de geography. Los resultados para STArea() son la unidad al cuadrado de la medida que el identificador de referencia espacial de la instancia de geography usa. Por ejemplo, si el SRID de la instancia es 4326, STArea() devuelve resultados en metros cuadrados.

Sintaxis

  
.STArea ( )  

Nota:

Para ver la sintaxis de Transact-SQL para SQL Server 2014 (12.x) y versiones anteriores, consulte Versiones anteriores de la documentación.

Tipos de valor devuelto

Tipo de valor devuelto de SQL Server: float

Tipo de valor devuelto de CLR: SqlDouble

Comentarios

STArea() devuelve cero si una instancia de geography contiene únicamente figuras no dimensionales o unidimensionales, o si está vacía.

Nota

Los métodos del tipo de datos geography que generan un valor devuelto métrico tendrán resultados diferentes en función del SRID de la instancia usada en el método. Para más información sobre los SRID, vea Identificadores de referencia espacial (SRID).

Ejemplos

En el ejemplo siguiente se usa STArea() para crear una instancia de Polygon geography y se calcula el área del 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 también

Métodos de OGC en instancias de Geography