st_centroid 函数

适用于:检查标记为“是”的 Databricks SQL 检查标记为“是”是 Databricks Runtime 17.1 及更高版本

Important

此功能目前以公共预览版提供。

注释

此功能在 Databricks SQL 经典仓库上不可用。 若要详细了解 Databricks SQL 仓库,请参阅 SQL 仓库类型

返回输入GEOMETRY值的质心,以 2D 点GEOMETRY值的形式。

Syntax

st_centroid ( geoExpr )

Arguments

  • geoExpr:一个 GEOMETRY 值。

Returns

返回输入 GEOMETRY 值的质心(作为二维点),并以几何图形形式呈现。 更确切地说:

  • 如果输入 GEOMETRY 值为空,则返回 2D 空点。
  • 如果输入 GEOMETRY 值仅包含点,则质心是点的 X 坐标和 Y 坐标的平均值。
  • 如果输入 GEOMETRY 值包含线性段(但不包含几何图形),质心是线性段中点的加权平均值,其中权重是段的长度。
  • 如果输入 GEOMETRY 值包含多边形,质心是多边形质心的加权平均值,其中权重是多边形的区域。

对于混合拓扑维度组件,质心计算基于具有最高拓扑维度的组件。 输出 GEOMETRY 值的 SRID 值与输入值的 SRID 值相同。

Examples

> 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)