- Categorias:
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_expressionO argumento deve ser uma expressão do tipo GEOMETRY.
distanceA distância do objeto GEOMETRY. Para “encolher” o objeto, você pode especificar um valor negativo para a distância.
Retornos¶
Retorna um objeto GEOMETRY.
Notas de uso¶
ST_BUFFER utiliza oito segmentos para aproximar um quarto de círculo.
Se
distancefor 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.
LineStings são sempre armazenados em buffer de ambos os lados.
Exemplos¶
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);
+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| ST_BUFFER(TO_GEOMETRY('POINT(0 0)'), 1) |
|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 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. Note que chamar 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))) |
+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+