適用対象: Databricks Runtime 17.1 以降
Important
この機能は パブリック プレビュー段階です。
指定した半径を使用して入力 GEOMETRY
のバッファーを返します。
Syntax
st_buffer ( geoExpr, radiusExpr )
Arguments
-
geoExpr
:GEOMETRY
値。 -
radiusExpr
: バッファーの半径としてDOUBLE
値。 半径の単位は、ジオメトリの座標系の単位です。
Returns
指定した半径を使用して入力 GEOMETRY
のバッファーを返します。
バッファーは、指定された半径が radiusExpr
のディスクを持つこのジオメトリの Minkowski 合計 (半径が負でない場合) または Minkowski の差 (半径が負の場合) です。 結果の境界は、理論上、円または円弧で構成されます。 ここでは、これらの円弧をポリラインで近似し、結果をジオメトリ値として返します。
結果は常に 2D ポリゴンまたはマルチポリゴンになります (入力内の Z 座標と M 座標は削除されます)。
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