共用方式為

st_centroid 函数

适用于：已勾选“是”的 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)