全部產品
Search
文件中心

MaxCompute:ST_BOUNDINGBOX

更新時間:Aug 27, 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));

相關文檔