STBuffer (geography 資料類型)

傳回 geography 物件，表示與 geography 執行個體之間的距離小於或等於指定值之所有點的聯集。

這個 geography 資料類型方法可支援 FullGlobe 執行個體或大於半球的空間執行個體。

語法

.STBuffer ( distance )

distance
這是 float 類型 (.NET Framework 中的 double) 的值，可指定與 geography 例項之間的距離 (將會從此例項的周圍計算緩衝)。

緩衝的最大距離不能超過 0.999 * π * minorAxis * minorAxis / majorAxis (~0.999 * 1/2 的地球圓周) 或完整的地球。

SQL Server 傳回類型：geography

CLR 傳回類型：SqlGeography

STBuffer() 會使用與 BufferWithTolerance 相同的方式計算緩衝，指定 tolerance = abs(distance) * .001 且 relative = false。

負數的緩衝會移除 geography 執行個體界限之給定距離內的所有點。

在某些情況下，STBuffer() 會傳回 FullGlobe 執行個體，例如，當緩衝距離大於兩極至赤道距離時，STBuffer() 會傳回 FullGlobe 執行個體。緩衝不能超過完整地球。

針對緩衝區距離超過下列限制的位置，這個方法將擲回 FullGlobe 執行個體中的 ArgumentException：

0.999 * π * minorAxis * minorAxis / majorAxis (~0.999 * 1/2 的地球圓周)

最大距離限制允許緩衝建構盡可能有彈性。

理論與計算所得之緩衝間的錯誤為 max(tolerance, extents * 1.E-7)，其中 tolerance = distance * .001。如需有關 extents 的詳細資訊，請參閱＜geography 資料類型方法參考＞。

下列範例會建立 LineString geography 執行個體。然後它會使用 STBuffer()，傳回此例項之 1 公尺內的區域。

DECLARE @g geography;
SET @g = geography::STGeomFromText('LINESTRING(-122.360 47.656, -122.343 47.656)', 4326);
SELECT @g.STBuffer(1).ToString();