全部产品
Search
文档中心

云原生大数据计算服务 MaxCompute:ST_BOUNDINGBOX

更新时间:Aug 26, 2026

ST_BOUNDINGBOX函数用来获取 GEOGRAPHY 值的BoundingBox信息。

命令格式

STRUCT ST_BOUNDINGBOX(GEOGRAPHY <value>)

参数说明

value:必填。GEOGRAPHY数据类型的地理对象。可根据需求使用ST_GEOGPOINTST_GEOGFROMWKBST_GEOGFROMTEXTST_MAKELINEST_MAKEPOLYGON函数来构造GEOGRAPHY类型对象。

返回值说明

返回STRUCT<xmin DOUBLE, ymin DOUBLE, xmax DOUBLE, ymax DOUBLE>类型,描述BoundingBox的坐标值范围。其中:

  • xmin:最小经度。

  • xmax:最大经度。

  • ymin:最小纬度。

  • ymax:最大纬度。

返回规则如下:

  • 输入NULL或空的地理对象,则返回NULL。

  • 由于MaxCompute的地理类型计算基于球面而非平面几何,此外调用S2库时也会带来很小的误差,因此返回值可能与输入坐标存在微小差异。

使用示例

  • 示例1:使用 ST_GEOGFROMTEXT 函数创建一个多边形,并通过 ST_BOUNDINGBOX 返回其BoundingBox的信息。

    SELECT ST_BOUNDINGBOX(ST_GEOGFROMTEXT('POLYGON ((0 0, 0.1 0, 0.1 0.1, 0 0.1, 0 0))'));
    
    -- 返回结果
    +------------------------------------------------------------------------------+
    | _c0                                                                          |
    +------------------------------------------------------------------------------+
    | {xmin:0.0, ymin:-3.8199962864073534e-14, xmax:0.1, ymax:0.10000003807717585} |
    +------------------------------------------------------------------------------+
  • 示例2:空值与空地理对象处理。

    -- 输入是空的地理对象,返回值是NULL
    SELECT ST_BOUNDINGBOX(ST_GEOGFROMTEXT('point empty'));
    
    -- 返回NULL
    SELECT ST_BOUNDINGBOX(ST_GEOGFROMTEXT(null));

相关文档