ST_Centroid - Amazon Redshift
構文引数戻り型例

Amazon Redshift は、2025 年 11 月 1 日以降、新しい Python UDF の作成をサポートしなくなります。Python UDF を使用する場合は、その日付より前に UDF を作成してください。既存の Python UDF は引き続き通常どおり機能します。詳細については、ブログ記事を参照してください。

ST_Centroid

ST_CentroID は、ジオメトリの重心を表すポイントを次のように返します。

  • POINT ジオメトリの場合、ジオメトリ内にあるポイントの座標の平均を座標とするポイントを返します。

  • LINESTRING ジオメトリの場合、ジオメトリのセグメントの中間点の加重平均を座標とするポイントを返します。この際、加重はジオメトリのセグメントの長さとなります。

  • POLYGON ジオメトリの場合、面積ジオメトリの三角形分割における重心の加重平均を座標とするポイントを返します。ここで加重は、三角形分割を構成する三角形の面積が使用されます。

  • ジオメトリコレクションの場合、ジオメトリコレクション内の最大トポロジディメンションの、ジオメトリにおける重心の加重平均を返します。

構文

ST_Centroid(geom)

引数

geom

データ型 GEOMETRY の値または GEOMETRY 型と評価される式の値。

戻り型

GEOMETRY

geom が null の場合、null が返されます。

geom が空の場合、null が返されます。

例

次の SQL は、入力ラインストリングの中心点を返します。

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)