st_centroid-Funktion

Gilt für: Databricks SQL Databricks Runtime 17.1 and above

Important

Dieses Feature befindet sich in der Public Preview.

Hinweis

Dieses Feature ist in Databricks SQL Classic Warehouses nicht verfügbar. Weitere Informationen zu Databricks SQL Warehouses finden Sie unter SQL Warehouse-Typen.

Gibt den Mittelpunkt des Eingabewerts GEOMETRY als 2D-Punktwert GEOMETRY zurück.

Syntax

st_centroid ( geoExpr )

Arguments

• geoExpr: Ein GEOMETRY Wert.

Returns

Gibt den Mittelpunkt (als 2D-Punkt) des Eingabewerts GEOMETRY als Geometrie zurück. Genauer gesagt:

• Wenn der Eingabewert GEOMETRY leer ist, wird der leere 2D-Punkt zurückgegeben.
• Wenn der Eingabewert GEOMETRY nur aus Punkten besteht, ist der Schwerpunkt als Durchschnitt der X- und Y-Koordinaten der Punkte zu berechnen.
• Wenn der Eingabewert GEOMETRY lineare Segmente (aber keine Arealgeometrien) enthält, ist der Schwerpunkt der gewichteten Mittelwerte der Mittelpunkte der linearen Segmente, wobei die Gewichtungen die Längen der Segmente sind.
• Wenn der Eingabewert GEOMETRY Polygone enthält, ist der Schwerpunkt der gewichtete Mittelwert der Schwerpunkte der Polygone, wobei die Gewichte die Flächen der Polygone sind.

Bei gemischten topologischen Dimensionen basiert die Zentroid-Berechnung auf den Komponenten mit der höchsten topologischen Dimension. Der SRID-Wert des Ausgabewerts GEOMETRY entspricht dem des Eingabewerts.

Examples

> SELECT st_asewkt(st_centroid(st_geomfromtext('POLYGON((1 0, 0.5 0.866, -0.5 0.866, -1 0, -0.5 -0.866, 0.5 -0.866, 1 0))', 3857)));
  SRID=3857;POINT(0 0)

Zugehörige Funktionen

• st_point Funktion
• st_envelope Funktion