STArea (type de données geography)STArea (geography Data Type)

S’APPLIQUE À : ouiSQL Server ouiAzure SQL Database nonAzure SQL Data Warehouse nonParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Retourne la surface d’exposition totale d’une instance geography.Returns the total surface area of a geography instance. 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.Results for STArea() are the squared unit of measure used by the geography instance's spatial reference identifier. Par exemple, si le SRID de l’instance est 4326, STArea() retourne les résultats en mètres carrés.For example, if the SRID of the instance is 4326, STArea() returns results in square meters.

SyntaxeSyntax

  
.STArea ( )  

Types de retourReturn Types

Type de retour SQL ServerSQL Server : floatSQL ServerSQL Server return type: float

Type de retour CLR : SqlDoubleCLR return type: SqlDouble

NotesRemarks

STArea() retourne 0 si l’instance geography est vide ou contient uniquement des figures à zéro et une dimension.STArea() returns 0 if a geography instance contains only zero- and one-dimensional figures, or if it's empty.

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.Methods on the geography data type that produce a metric return value will have different results based on the SRID of the instance used in the method. Pour plus d’informations sur les SRID, consultez Identificateurs de référence spatiale (SRID).For more information on SRIDs, see Spatial Reference Identifiers (SRIDs).

ExemplesExamples

L’exemple suivant utilise STArea() pour créer une instance Polygon geography et calcule la surface du polygone.The following example uses STArea() to create a Polygon geography instance and computes the area of the polygon.

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 aussiSee Also

Méthodes OGC sur des instances geographyOGC Methods on Geography Instances