ST_Envelope - Amazon Redshift
SintaxeArgumentosTipo de retornoExemplos

ST_Envelope

ST_Envelope retorna a caixa delimitadora mínima da geometria de entrada, da seguinte forma:

  • Se a geometria de entrada for vazia, a geometria retornada será uma cópia da geometria de entrada.

  • Se a caixa delimitadora mínima da geometria de entrada se degenerar para um ponto, a geometria retornada será um ponto.

  • Se a caixa delimitadora mínima da geometria de entrada for unidimensional, será retornada uma linestring de dois pontos.

  • Se nenhum dos anteriores for verdadeiro, a função retornará um polígono orientado no sentido horário, cujos vértices serão os cantos da caixa delimitadora mínima.

O Spatial Reference System Identifier (SRID – Identificador do sistema de referência espacial) da geometria retornada é o mesmo da geometria de entrada.

Para todas as entradas não vazias, a função opera na projeção 2D da geometria de entrada.

Sintaxe

ST_Envelope(geom)

Argumentos

geom

Um valor de tipo de dados GEOMETRY ou uma expressão que é avaliada como um tipo GEOMETRY.

Tipo de retorno

GEOMETRY

Nulo será retornado se geom for nulo.

Exemplos

O SQL a seguir converte uma representação de Well-known text (WKT – Texto bem-conhecido) de uma LINESTRING de quatro pontos para um objeto GEOMETRY e retorna um polígono cujos vértices são a caixa delimitadora mínima. 

SELECT ST_AsText(ST_Envelope(ST_GeomFromText('GEOMETRYCOLLECTION(POLYGON((0 0,10 0,0 10,0 0)),LINESTRING(20 10,20 0,10 0))')));

    st_astext
------------------------------------
  POLYGON((0 0,0 10,20 10,20 0,0 0))