STArea (tipo de datos geography)
Se aplica a: SQL Server Azure SQL Database Azure SQL Managed Instance Base de datos de Azure SQL de Microsoft Fabric
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 ( )
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();