STArea (type de données geography)

Retourne la surface d'exposition totale d'une instance geography. Les résultats de STArea() sont retournés dans le carré de l'unité de mesure utilisée par l'identificateur de référence spatial 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 ( )

Types des valeurs de retour

Type de retour SQL Server : float

Type de retour CLR : SqlDouble

Notes

STArea() retourne 0 si une instance geography contient uniquement des figures à 0 et 1 dimension, ou si elle est vide.

[!REMARQUE]

Les méthodes sur le type de données geography qui produisent une valeur de retour métrique auront des résultats différents selon le SRID de l'instance utilisé 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 Polygongeography 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

Autres ressources