Todos os produtos
Search
Central de documentação

MaxCompute:ST_BOUNDINGBOX

Última atualização: Aug 26, 2026

A função ST_BOUNDINGBOX retorna a caixa delimitadora de um objeto GEOGRAPHY.

Sintaxe

STRUCT ST_BOUNDINGBOX(GEOGRAPHY <value>)

Parâmetros

value: Obrigatório. Um valor do tipo de dados GEOGRAPHY data type. Use funções como ST_GEOGPOINT, ST_GEOGFROMWKB, ST_GEOGFROMTEXT, ST_MAKELINE e ST_MAKEPOLYGON para crie objetos GEOGRAPHY.

Valor de retorno

Retorna um valor STRUCT<xmin DOUBLE, ymin DOUBLE, xmax DOUBLE, ymax DOUBLE> que descreve o intervalo de coordenadas da caixa delimitadora. Os campos são:

  • xmin: A longitude mínima.

  • xmax: A longitude máxima.

  • ymin: A latitude mínima.

  • ymax: A latitude máxima.

A função segue estas regras:

  • Se a entrada for nula ou um objeto GEOGRAPHY vazio, a função retorna NULL.

  • O MaxCompute executa cálculos geoespaciais em uma esfera, não com geometria plana. Além disso, a biblioteca S2 subjacente pode introduzir pequenos erros de precisão. Por isso, as coordenadas retornadas podem diferir ligeiramente das coordenadas de entrada.

Exemplos

  • Exemplo 1: Use a função ST_GEOGFROMTEXT para crie um polígono e retornar sua caixa delimitadora.

    SELECT ST_BOUNDINGBOX(ST_GEOGFROMTEXT('POLYGON ((0 0, 0.1 0, 0.1 0.1, 0 0.1, 0 0))'));
    
    -- Returns:
    +------------------------------------------------------------------------------+
    | _c0                                                                          |
    +------------------------------------------------------------------------------+
    | {xmin:0.0, ymin:-3.8199962864073534e-14, xmax:0.1, ymax:0.10000003807717585} |
    +------------------------------------------------------------------------------+
  • Exemplo 2: Trate valores nulos e objetos GEOGRAPHY vazios.

    -- The input is an empty geography object. The function returns NULL.
    SELECT ST_BOUNDINGBOX(ST_GEOGFROMTEXT('point empty'));
    
    -- The input is null. The function returns NULL.
    SELECT ST_BOUNDINGBOX(ST_GEOGFROMTEXT(null));

Tópicos relacionados