ST_Centroid - Amazon Redshift
SyntaxArgumenteRückgabetypBeispiele

Amazon Redshift unterstützt ab dem 1. November 2025 nicht mehr die Erstellung neuer Python-UDFs. Wenn Sie Python-UDFs verwenden möchten, erstellen Sie die UDFs vor diesem Datum. Bestehende Python-UDFs funktionieren weiterhin wie gewohnt. Weitere Informationen finden Sie im Blog-Posting.

ST_Centroid

ST_Centroid gibt einen Punkt zurück, der einen Schwerpunkt einer Geometrie darstellt, und zwar wie folgt:

  • Für POINT-Geometrien gibt ST_Centroid den Punkt zurück, dessen Koordinaten die durchschnittlichen Koordinaten der Punkte in der Geometrie sind.

  • Für LINESTRING-Geometrien gibt ST_Centroid den Punkt zurück, dessen Koordinaten der gewichtete Durchschnitt der Mittelpunkte der Segmente der Geometrie sind, wobei die Gewichte die Längen der Segmente in der Geometrie sind.

  • Für POLYGON-Geometrien gibt ST_Centroid den Punkt zurück, dessen Koordinaten der gewichtete Durchschnitt der Schwerpunkte einer Triangulation der Flächengeometrie sind, wobei die Gewichte die Flächen der Dreiecke in der Triangulation sind.

  • Für Geometriesammlungen gibt ST_Centroid den gewichteten Durchschnitt der Schwerpunkte der Geometrien mit maximaler topologischer Dimension in der Geometriesammlung zurück.

Syntax

ST_Centroid(geom)

Argumente

geom

Ein Wert vom Datentyp GEOMETRY oder ein Ausdruck, der zu einem GEOMETRY-Typ ausgewertet wird.

Rückgabetyp

GEOMETRY

Wenn geom null ist, wird null zurückgegeben.

Wenn geom leer ist, wird null zurückgegeben.

Beispiele

Das folgende SQL gibt einen zentralen Punkt aus einem Eingabe-Linestring zurück. 

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)