Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

ST_Area

Pour une géographie d’entrée, ST_Area renvoie la zone cartésienne de la projection 2D. Les unités de surface sont les mêmes que les unités dans lesquelles les coordonnées de la géométrie en entrée sont exprimées. Pour les points, les linestrings, les multipoints et les multilinestrings, la fonction renvoie 0. Pour les collections de géométrie, elle renvoie la somme des zones des géométries de la collection.

Pour une géographie d’entrée, ST_Area renvoie la zone géodésique de la projection 2D d’une géographie surfacique en entrée calculée sur le sphéroïde déterminé par le SRID. L’unité de longueur est en mètres carrés. La fonction renvoie zéro (0) pour les points, les multipoints et les géomgraphies linéaires. Lorsque l’entrée est une collection de géométries, la fonction renvoie la somme des zones des géographies surfaciques de la collection.

Syntaxe

ST_Area(geo)

Arguments

Type de retour

DOUBLE PRECISION

Si geo est null, null est renvoyé.

Exemples

Le SQL suivant renvoie la zone cartésienne d’un multipolygone.

SELECT ST_Area(ST_GeomFromText('MULTIPOLYGON(((0 0,10 0,0 10,0 0)),((10 0,20 0,20 10,10 0)))'));

 st_area
---------
     100

Le code SQL suivant renvoie la zone d’un polygone point dans une géographie.

SELECT ST_Area(ST_GeogFromText('polygon((34 35, 28 30, 25 34, 34 35))'));

     st_area
------------------
 201824655743.383

Le code SQL suivant renvoie zéro pour une géographie linéaire.

SELECT ST_Area(ST_GeogFromText('multipoint(0 0, 1 1, -21.32 121.2)'));

 st_area
---------
       0