Partager via


st_buffer Fonction

S’applique à :check marqué oui Databricks SQL vérifié marqué oui Databricks Runtime 17.1 et versions ultérieures

Important

Cette fonctionnalité est disponible en préversion publique.

Note

Cette fonctionnalité n’est pas disponible sur les entrepôts Databricks SQL Classic. Pour en savoir plus sur les entrepôts SQL Databricks, consultez les types d’entrepôts SQL.

Retourne la mémoire tampon de la valeur d’entrée GEOMETRY à l’aide du rayon spécifié.

Syntax

st_buffer ( geoExpr, radiusExpr )

Arguments

  • geoExpr: une valeur de GEOMETRY.
  • radiusExpr: valeur DOUBLE en tant que rayon de la mémoire tampon. L’unité du rayon est celle du système de référence de coordonnées de la géométrie.

Returns

Retourne la mémoire tampon de la valeur d’entrée GEOMETRY à l’aide du rayon spécifié. La mémoire tampon est la somme Minkowski (si le rayon est non négatif) ou la différence Minkowski (si le rayon est négatif) de cette géométrie avec un disque dont le rayon est le rayon radiusExprdonné. La limite du résultat se compose, en théorie, de cercles ou d’arcs circulaires. Ici, nous approchons ces arcs avec des polylignes et renvoyons le résultat sous la forme d'une valeur géométrique. Le résultat est toujours un polygone 2D ou un multipolygon (coordonnées Z et M dans l’entrée sont supprimées).

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