View a markdown version of this page

ST_Centroid - Amazon Redshift
SyntaxeArgumentsType de retourExemples

Amazon Redshift ne prendra plus en charge l'utilisation des UDF Python après le 30 juin 2026. Nous allons commencer à l'appliquer par étapes. Pour plus d'informations sur les options de fin de vie et de migration de Python, consultez le billet de blog publié le 30 juin 2025.

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_Centroid

ST_CentroID renvoie un point qui représente un centroïde d’une géométrie comme suit :

  • Pour les géométries POINT, il renvoie le point dont les coordonnées sont la moyenne des coordonnées des points de la géométrie.

  • Pour les géométries LINESTRING, il renvoie le point dont les coordonnées sont la moyenne pondérée des points médians des segments de la géométrie, où les poids sont les longueurs des segments de la géométrie.

  • Pour les géométries POLYGON, il renvoie le point dont les coordonnées sont la moyenne pondérée des centroïdes d’une triangulation de la géométrie surfacique où les poids sont les zones des triangles dans la triangulation.

  • Pour les collections de géométrie, elle renvoie la moyenne pondérée des centroïdes des géométries de dimension topologique maximale de la collection de géométries.

Syntaxe

ST_Centroid(geom)

Arguments

geom

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

Type de retour

GEOMETRY

Si geom est null, null est renvoyé.

Si geom est vide, null est renvoyé.

Exemples

Le code SQL suivant renvoie un point central d’une linestring d’entrée. 

SELECT ST_AsEWKT(ST_Centroid(ST_GeomFromText('LINESTRING(110 40, 2 3, -10 80, -7 9, -22 -33)', 4326)))

                     st_asewkt
----------------------------------------------------
 SRID=4326;POINT(15.6965103455214 27.0206782881905)