共用方式為

Reduce (geometry 資料類型)

  • 發行項

適用於：SQL ServerAzure SQL 資料庫 Azure SQL 受控執行個體

傳回指定 geometry 執行個體的近似值。 在執行個體上以所指定容錯執行 Douglas-Peucker 演算法的延伸模組，即可產生該近似值。

Syntax

  
.Reduce ( tolerance )

注意

若要檢視 SQL Server 2014 (12.x) 和更早版本的 Transact-SQL 語法，請參閱舊版文件。

引數

tolerance
這是 float 類型的值。 tolerance 是近似值演算法的輸入容錯。

傳回型別

SQL Server 傳回類型：geometry

CLR 傳回類型：SqlGeometry

備註

就集合類型而言，此演算法會在執行個體所含的每個 geometry 上獨立運作。

此演算法不會修改 Point 執行個體。

在 LineString、CircularString 和 CompoundCurve 執行個體上，近似值演算法會保留執行個體的原始起點和終點。 此演算法接著會將原始執行個體中最偏離結果的點反覆地新增回來。 此處理序會繼續執行，直到任何點的偏差都不會超過所指定容錯為止。

Reduce() 會傳回 CircularString 執行個體的 LineString、CircularString或 CompoundCurve 執行個體。 Reduce() 會傳回 CompoundCurve 執行個體的 CompoundCurve 或 LineString 執行個體。

在 Polygon 執行個體上，近似值演算法會獨立套用到每一個環形。 如果傳回的 Polygon 執行個體無效，此方法將會產生 FormatException；例如，如果套用 Reduce() 來簡化執行個體中的每一個環形，而產生的環形發生重疊，就會建立無效的 MultiPolygon 執行個體。 在具有外環但沒有內環的 CurvePolygon 執行個體上，Reduce() 會傳回 CurvePolygon、LineString 或 Point 執行個體。 如果 CurvePolygon 具有內環，則會傳回 CurvePolygon 或 MultiPoint 執行個體。

在發現圓弧線段時，近似值演算法會檢查弧形是否可依據其弦在指定容錯的一半內求得近似值。 當弦符合此準則時，在計算中弦會取代圓弧。 如果弦不符合此準則，則會保留圓弧，且近似值演算法會套用至剩餘的線段。

範例

A. 使用 Reduce() 以簡化 LineString

下列範例會建立 LineString 執行個體，並使用 Reduce() 來簡化此執行個體。

DECLARE @g geometry;  
SET @g = geometry::STGeomFromText('LINESTRING(0 0, 0 1, 1 0, 2 1, 3 0, 4 1)', 0);  
SELECT @g.Reduce(.75).ToString();

B. 在 CircularString 上使用 Reduce() 搭配不同的容錯層級

下列範例會在 CircularString 執行個體上使用 Reduce()搭配三個容錯層級：

 DECLARE @g geometry = 'CIRCULARSTRING(0 0, 8 8, 16 0, 20 -4, 24 0)'; 
 SELECT @g.Reduce(5).ToString(); 
 SELECT @g.Reduce(15).ToString(); 
 SELECT @g.Reduce(16).ToString();

這個範例會產生下列輸出：

CIRCULARSTRING (0 0, 8 8, 16 0, 20 -4, 24 0) 
COMPOUNDCURVE (CIRCULARSTRING (0 0, 8 8, 16 0), (16 0, 24 0)) 
LINESTRING (0 0, 24 0)

每個傳回的執行個體都會包含端點 (0 0) 和 (24 0)。

C. 在 CompoundCurve 上使用 Reduce() 搭配不同的容錯層級

下列範例會在 CompoundCurve 執行個體上使用 Reduce() 搭配兩個容錯層級：

 DECLARE @g geometry = 'COMPOUNDCURVE(CIRCULARSTRING(0 0, 8 8, 16 0, 20 -4, 24 0),(24 0, 20 4, 16 0))';  
 SELECT @g.Reduce(15).ToString();  
 SELECT @g.Reduce(16).ToString();

在這個範例中，請注意，第二個 SELECT 陳述式會傳回 LineString執行個體：LineString(0 0, 16 0)。

示範原始起點和終點遺失的範例

下列範例示範結果執行個體可能無法保留原始起點和終點的狀況。 因為保留原始起點和終點會導致產生無效的 LineString 執行個體，所以會發生此狀況。

DECLARE @g geometry = 'LINESTRING(0 0, 4 0, 2 .01, 1 0)';  
DECLARE @h geometry = @g.Reduce(1);  
SELECT @g.STIsValid() AS Valid  
SELECT @g.ToString() AS Original, @h.ToString() AS Reduced;

另請參閱

擴充的靜態幾何方法