st_buffer Função

Aplica-se a: Databricks SQL Databricks Runtime 17.1 and above

Retorna o buffer do valor de entrada GEOMETRY usando o raio especificado.

Syntax

st_buffer ( geoExpr, radiusExpr )

Arguments

• geoExpr: valor de GEOMETRY.
• radiusExpr: um valor de DOUBLE como raio do buffer. A unidade do raio é a do sistema de referência de coordenadas da geometria.

Returns

Retorna o buffer do valor de entrada GEOMETRY usando o raio especificado. O buffer é a soma de Minkowski (se o raio não for negativo) ou a diferença de Minkowski (se o raio for negativo) dessa geometria com um disco cujo raio é o raio radiusExpr fornecido. O limite do resultado consiste, em teoria, em círculos ou arcos circulares. Aqui, aproximamos esses arcos com polilinhas e retornamos o resultado como um valor de geometria. O resultado é sempre um polígono 2D ou multipolígono (as coordenadas Z e M na entrada são descartadas).

Examples

-- Expands a point into a circle-like polygon with a 1-unit radius.
> SELECT st_astext(st_envelope(st_buffer(st_geomfromtext('POINT(0 0)'), 1)));
  POLYGON((-1 -1,-1 1,1 1,1 -1,-1 -1))

-- Shrinks a small polygon so much that nothing is left
> SELECT st_astext(st_buffer(st_geomfromtext('POLYGON((0 0,2 0,2 2,0 2,0 0))'), -5));
  POLYGON EMPTY

Funções relacionadas

• st_distance função
• st_union função
• st_intersection função