STArea (type de données geography)

  • Article

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

Retourne la surface d’exposition totale d’une instance geography. Les résultats de STArea() sont l’unité de mesure au carré utilisée par l’identificateur de référence spatiale de l’instance geography. Par exemple, si le SRID de l’instance est 4326, STArea() retourne les résultats en mètres carrés.

Syntaxe

  
.STArea ( )

Remarque

Pour afficher la syntaxe Transact-SQL pour SQL Server 2014 (12.x) et versions antérieures, consultez la Documentation sur les versions antérieures.

Types de retour

Type de retour SQL Server : float

Type de retour CLR : SqlDouble

Remarques

STArea() retourne 0 si l’instance geography est vide ou contient uniquement des figures à zéro et une dimension.

Notes

Les méthodes du type de données geography qui produisent une valeur de retour métrique ont des résultats distincts selon le SRID de l’instance utilisée dans la méthode. Pour plus d’informations sur les SRID, consultez Identificateurs de référence spatiale (SRID).

Exemples

L’exemple suivant utilise STArea() pour créer une instance Polygon geography et calcule la surface du polygone.

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

Voir aussi

Méthodes OGC sur des instances Geography