ST_Area - Amazon Redshift

Amazon Redshift ne prendra plus en charge la création de nouveaux Python UDFs à compter du 1er novembre 2025. Si vous souhaitez utiliser Python UDFs, créez la version UDFs antérieure à cette date. Le Python existant UDFs continuera à fonctionner normalement. Pour plus d'informations, consultez le billet de blog.

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

geo

Valeur de type de données GEOMETRY ou GEOGRAPHY ou expression qui est évaluée sur un type GEOMETRY ou GEOGRAPHY.

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