BufferWithTolerance(geography 数据类型)
适用于: SQL Server Azure SQL 数据库 Azure SQL 托管实例
返回表示所有点值的并集的几何对象,这些点到 geography 实例的距离小于或等于指定值,允许存在指定公差。
这种 geography 数据类型方法支持大于半球的 FullGlobe 实例或空间实例。
语法
.BufferWithTolerance ( distance, tolerance, relative )
参数
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();