Categorias:

Funções geospaciais

ST_BUFFER

Retorna um objeto GEOMETRY que representa um MultiPolygon contendo os pontos dentro de uma distância especificada do objeto de entrada GEOMETRY. O objeto retornado representa efetivamente um “buffer” em torno do objeto de entrada.

Você também pode “encolher” o objeto de entrada, especificando um valor negativo para a distância.

Sintaxe

ST_BUFFER( <geometry_expression> , <distance> )

Argumentos

geometry_expression

O argumento deve ser uma expressão do tipo GEOMETRY.

distance

A distância do objeto GEOMETRY. Para “encolher” o objeto, você pode especificar um valor negativo para a distância.

As unidades dependem do identificador de sistema de referência espacial (SRID) do objeto GEOMETRY. Por exemplo, unidades ESPG:4326 são graus, enquanto unidades ESPG: 25855 são metros.

Retornos

Retorna um objeto GEOMETRY.

Notas de uso

  • SRIDs são baseados no padrão EPSG (v10.082). Por exemplo, o SRID 4326 corresponde ao EPSG de autoridade com o código 4326.

  • ST_BUFFER utiliza oito segmentos para aproximar um quarto de círculo.

  • Se distance for um valor negativo, o objeto retornado será menor do que o objeto de entrada. Você pode usar isto para remover pequenas irregularidades da forma.

  • Para LineStrings, os estilos endcap e join são sempre redondos.

  • LineStrings são sempre armazenados em buffer de ambos os lados.

Exemplos

Antes de executar os exemplos, defina o parâmetro GEOMETRY_OUTPUT_FORMAT como WKT:

ALTER SESSION SET GEOMETRY_OUTPUT_FORMAT='WKT';

O exemplo a seguir retorna um polígono em torno de um ponto com um raio de um:

SELECT ST_BUFFER(TO_GEOMETRY('POINT(0 0)'), 1) AS geom;

+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| GEOM                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| MULTIPOLYGON(((1 0,0.9807852804 -0.195090322,0.9238795325 -0.3826834324,0.8314696123 -0.555570233,0.7071067812 -0.7071067812,0.555570233 -0.8314696123,0.3826834324 -0.9238795325,0.195090322 -0.9807852804,6.123233996e-17 -1,-0.195090322 -0.9807852804,-0.3826834324 -0.9238795325,-0.555570233 -0.8314696123,-0.7071067812 -0.7071067812,-0.8314696123 -0.555570233,-0.9238795325 -0.3826834324,-0.9807852804 -0.195090322,-1 7.657137398e-16,-0.9807852804 0.195090322,-0.9238795325 0.3826834324,-0.8314696123 0.555570233,-0.7071067812 0.7071067812,-0.555570233 0.8314696123,-0.3826834324 0.9238795325,-0.195090322 0.9807852804,2.480838239e-15 1,0.195090322 0.9807852804,0.3826834324 0.9238795325,0.555570233 0.8314696123,0.7071067812 0.7071067812,0.8314696123 0.555570233,0.9238795325 0.3826834324,0.9807852804 0.195090322,1 0))) |
+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

O exemplo a seguir usa um valor negativo para distance para remover pequenas irregularidades (como picos) da forma. A chamada TO_GEOMETRY passa TRUE como segundo argumento, o que permite que a função crie um objeto GEOMETRY para uma forma inválida.

SELECT ST_BUFFER(TO_GEOMETRY('SRID=2261;POLYGON((
  1540792.21541900 290472.63529214, 1547018.61770388 302537.02285369,
  1546965.96550151 302752.51514772, 1547018.61770388 302537.02285369,
  1549532.42729914 301257.07398027, 1543327.42218339 289322.60923536,
  1540792.21541900 290472.63529214))', True), -1e-08) AS geom;

+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| GEOM                                                                                                                                                                                        |
|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| MULTIPOLYGON(((1543327.42218339 289322.609235373,1540792.21541901 290472.635292145,1547018.61770388 302537.022853677,1549532.42729913 301257.073980266,1543327.42218339 289322.609235373))) |
+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+