Name

ST_Centroid — 返回几何体的几何中心。

Synopsis

geometry ST_Centroid(geometry g1);

geography ST_Centroid(geography g1, boolean use_spheroid = true);

描述

计算作为几何体的几何质心的点。 对于 [MULTI]POINT,质心是输入坐标的算术平均值。 对于 [MULTI]LINESTRING,质心是使用每条线段的加权长度计算的。 对于 [MULTI]POLYGON,质心是根据面积计算的。 如果提供了空几何图形,则返回空的GEOMETRYCOLLECTION。 如果提供 NULL,则返回 NULL。 如果提供了CIRCULARSTRINGCOMPOUNDCURVE,它们首先使用CurveToLine转换为线串,然后与LINESTRING相同

对于混合维度输入,结果等于最高维度的组件几何图形的质心(因为较低维度的几何图形对质心的“权重”贡献为零)。

请注意,对于多边形几何形状,质心不一定位于多边形的内部。 例如,请参见下图 C 形多边形的质心。 要构造保证位于多边形内部的点,请使用 ST_PointOnSurface

2.3.0 中的新增功能:支持 CIRCULARSTRINGCOMPOUNDCURVE(使用 CurveToLine)

可用性:2.4.0 引入了对地理的支持。

此方法实现了 SQL 1.1 的 OGC 简单功能规范。

该方法实现了SQL/MM规范。 SQL-MM 3: 8.1.4, 9.5.5

示例

在下图中,红点是源几何体的质心。

MULTIPOINT的质心

LINESTRING的质心

POLYGON的质心

GEOMETRYCOLLECTION的质心

SELECT ST_AsText(ST_Centroid('MULTIPOINT ( -1 0, -1 2, -1 3, -1 4, -1 7, 0 1, 0 3, 1 1, 2 0, 6 0, 7 8, 9 8, 10 6 )'));
                st_astext
------------------------------------------
 POINT(2.30769230769231 3.30769230769231)
(1 row)

SELECT ST_AsText(ST_centroid(g))
FROM  ST_GeomFromText('CIRCULARSTRING(0 2, -1 1,0 0, 0.5 0, 1 0, 2 1, 1 2, 0.5 2, 0 2)')  AS g ;
------------------------------------------
POINT(0.5 1)


SELECT ST_AsText(ST_centroid(g))
FROM  ST_GeomFromText('COMPOUNDCURVE(CIRCULARSTRING(0 2, -1 1,0 0),(0 0, 0.5 0, 1 0),CIRCULARSTRING( 1 0, 2 1, 1 2),(1 2, 0.5 2, 0 2))' ) AS g;
------------------------------------------
POINT(0.5 1)