适用于: Databricks Runtime 17.1 及更高版本
重要
此功能目前以公共预览版提供。
以 2D 点GEOMETRY
的形式返回输入GEOMETRY
的质心。
语法
st_centroid ( geoExpr )
论据
-
geoExpr
:一个GEOMETRY
值。
退货
返回输入 GEOMETRY
的质心(以 2D 点形式),将其作为几何图形。该质心可通过 GEOMETRY
值或采用标准地理空间格式进行表示。
更确切地说:
- 如果输入
GEOMETRY
为空,则返回 2D 空点。 - 如果输入
GEOMETRY
仅包含点,则质心是点的 X 和 Y 坐标的平均值。 - 如果输入
GEOMETRY
包含线性段(但不包含非几何图形),质心是线性段中点的加权平均值,其中权重是段的长度。 - 如果输入
GEOMETRY
包含多边形,质心是多边形质心的加权平均值,其中权重是多边形的区域。
对于混合拓扑维度组件,质心计算基于具有最高拓扑维度的组件。
输出 GEOMETRY
的 SRID 值与输入值的值相同。
例子
> 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)