STBuffer (geometry データ型)

geometry インスタンスからの距離が指定した値以下となる、すべての地点の和集合を表すジオメトリック オブジェクトを返します。

構文

.STBuffer (distance)

引数

  • distance
    geometry インスタンスからのバッファーの幅の距離を指定するための float (.NET Framework では double) 型の値です。

戻り値の型

SQL Server の戻り値の型 : geometry

CLR の戻り値の型 : SqlGeometry

説明

STBuffer() は、tolerance = distance * .001、relative = false を指定して BufferWithTolerance を呼び出すのと同じ方法でバッファーを計算します。

バッファーに負の値を指定すると、geometry インスタンスの境界から、指定された距離の範囲内にある地点をすべて削除します。理論的に計算されたバッファー間の誤差は、max(tolerance, extents * 1.E-7) です。ここで、tolerance = distance * .001 です。計算済み誤差の詳細については、「geometry データ型メソッド リファレンス」を参照してください。

次の例では、LineStringgeometry インスタンスを作成します。次に、STBuffer() を使用して、インスタンスから 1 単位内にある領域を返します。

DECLARE @g geometry;
SET @g = geometry::STGeomFromText('LINESTRING(0 0, 4 0)', 0);
SELECT @g.STBuffer(1).ToString();