Name

ST_Centroid — 返回几何图形的几何中心。

Synopsis

geometry ST_Centroid(geometry g1);

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

描述

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

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

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

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

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

This method implements the OGC Simple Features Implementation Specification for SQL 1.1.

This method implements the SQL/MM specification. SQL-MM 3:8.1.4、9.5.5

示例

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

A的质心 MULTIPOINT

A的质心 LINESTRING

A的质心 POLYGON

A的质心 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)

另请参阅

ST_PointOnSurface, ST_GeometricMedian