BufferWithTolerance（geography 数据类型）

  • 项目

适用于：SQL ServerAzure SQL 数据库Azure SQL 托管实例

返回表示所有点值的并集的几何对象，这些点到 geography 实例的距离小于或等于指定值，允许存在指定公差。

这种 geography 数据类型方法支持大于半球的 FullGlobe 实例或空间实例。

语法

  
.BufferWithTolerance ( distance, tolerance, relative )

注意

若要查看 SQL Server 2014 (12.x) 及更早版本的 Transact-SQL 语法，请参阅早期版本文档。

参数

distance
一个 float 表达式，用于指定与围绕其计算缓冲区的 geography 实例的距离。

缓冲区的最大距离不得超过 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 参数的值。 有关盘区的详细信息，请参阅 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 数据类型）
地理实例上的扩展方法