共用方式為


BufferWithTolerance (geography 資料類型)

傳回幾何物件,此物件表示與 geography 執行個體之間的距離小於或等於指定值 (允許有指定的容錯) 之所有點值的聯集。

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

語法

.BufferWithTolerance ( distance, tolerance, relative )

引數

  • distance
    這是指定與 geography 執行個體之間距離的 float 運算式,將會從此執行個體的周圍計算緩衝。

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

  • tolerance
    這是 float 運算式,它會指定緩衝距離的容錯。

    「容錯」(Tolerance) 值指的是傳回之線性近似值之理想緩衝距離的最大變異。

    例如,點的理想緩衝距離是圓形,但是這必須由多邊形來模擬。 當容錯越小時,多邊形就會有越多的點,這樣會增加結果的複雜度,但是會減少錯誤。

    最小限制為 0.1% 的距離,而且小於該值的和任何容錯將會四捨五入至最小限制。

  • relative
    這是指定 tolerance 值為相對或絕對的 bit。 如果為 'TRUE' 或 1,則容錯為相對值,而且會計算為 tolerance 參數與角度 * 橢圓體半徑的乘積。 如果為 'FALSE' 或 0,則容錯為絕對值,而且 tolerance 值是傳回之線性近似值之理想緩衝距離的最大絕對變異值。

傳回類型

SQL Server 傳回類型:geography

CLR 傳回類型: SqlGeography

備註

如果 distance 不是數字 (NAN),或如果 distance 是正的或負的無限值,這個方法將會擲回 ArgumentException。 如果 tolerance 是零 (0) 而不是數字 (NAN) 或正的或負的無限值,這個方法也將擲回 ArgumentException。

在某些情況下,STBuffer() 會傳回 FullGlobe 執行個體,例如,當緩衝距離大於兩極至赤道距離時,STBuffer() 會傳回兩極上的 FullGlobe 執行個體。

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

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

理論上和計算的緩衝之間的誤差為 max(tolerance, extents * 1.E-7),其中 tolerance 是 tolerance 參數的值。 如需有關 extents 的詳細資訊,請參閱<geography 資料類型方法參考>。

這個方法並不精確。

範例

下列範例會建立 Point 執行個體,並使用 BufferWithTolerance() 來取得其周圍的約略緩衝。

DECLARE @g geography;
SET @g = geography::STGeomFromText('POINT(-122.34900 47.65100)', 4326);
SELECT @g.BufferWithTolerance(1, .5, 0).ToString();

請參閱

參考

STBuffer (geography 資料類型)

其他資源

地理位置例項上擴充的方法