返回包含圆弧线段的 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 实例,而为 Polygon 实例返回 CurvePolygon 实例。
示例
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 实例上使用该方法
以下示例显示从仅包含一个 LineString 实例的 MultiLineString 实例中返回的内容:
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 实例上使用该方法
以下示例显示从包含多个 LineString 实例的 MultiLineString 实例中返回的内容:
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();