CurveToLineWithTolerance(geography 数据类型)
适用于:SQL Server
Azure SQL 数据库
Azure SQL 托管实例
Microsoft Fabric SQL 数据库
返回包含圆弧线段的 geography 实例的多边形近似值。
语法
.CurveToLineWithTolerance( tolerance, relative )
参数
tolerance
一个 double 表达式,它定义原始圆弧线段与其线性近似值之间的最大误差。
relative
一个 bool 表达式,它指示是否使用偏差的相对最大值。 如果 relative 设置为 false (0),则为可能具有线性近似的偏差设置绝对最大值。 如果 relative 设置为 true (1),则按 tolerance 参数与空间对象边界框直径的乘积来计算容差。
返回类型
SQL Server 返回类型:geography
CLR 返回类型:SqlGeography
例外
将 tolerance 设置为 <= 0 会引发 ArgumentOutOfRange 异常。
备注
此方法允许为生成的 LineString 指定公差大小。
CurveToLineWithTolerance 方法将为 CircularString 或 CompoundCurve 实例返回 LineString 实例,为 CurvePolygon 实例返回 Polygon 实例。
示例
A. 在 CircularString 实例上使用不同的公差值
以下示例说明设置容差如何影响从 CircularString
实例返回的 LineString
实例:
DECLARE @g geography;
SET @g = geography::Parse('CIRCULARSTRING(-122.358 47.653, -122.348 47.649, -122.348 47.658, -122.358 47.658, -122.358 47.653)');
SELECT @g.CurveToLineWithTolerance(0.1,0).STNumPoints(), @g.CurveToLineWithTolerance(0.01, 0).STNumPoints();
B. 在包含一个 LineString 的 MultiLineString 实例上使用该方法
以下示例显示从仅包含一个 MultiLineString
实例的 LineString
实例中返回的内容:
DECLARE @g geography;
SET @g = geography::Parse('MULTILINESTRING((-122.358 47.653, -122.348 47.649))');
SELECT @g.CurveToLineWithTolerance(0.1,0).ToString();
C. 在包含多个 LineString 的 MultiLineString 实例上使用该方法
以下示例显示从包含多个 MultiLineString
实例的 LineString
实例中返回的内容:
DECLARE @g geography;
SET @g = geography::Parse('MULTILINESTRING((-122.358 47.653, -122.348 47.649),(-123.358 47.653, -123.348 47.649))');
SELECT @g.CurveToLineWithTolerance(0.1,0).ToString();
D. 对于调用 CurvePolygon 实例,将 relative 设置为 true
以下示例使用 CurvePolygon
实例调用 CurveToLineWithTolerance()
并将 relative 设置为 true:
DECLARE @g geography = 'CURVEPOLYGON(COMPOUNDCURVE(CIRCULARSTRING(-122.358 47.653, -122.348 47.649, -122.348 47.658), (-122.348 47.658, -122.358 47.658, -122.358 47.653)))';
SELECT @g.CurveToLineWithTolerance(.5,1).ToString();