STBuffer (geography 資料類型)
適用於:Microsoft Fabric 中的 SQL Server
Azure SQL 資料庫 Azure SQL 受控執行個體
SQL 資料庫
傳回 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。 如需有關範圍的詳細資訊,請參閱 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();