建立、建構及查詢幾何執行個體

非空的 geometry 執行個體可以是 0 維度、1 維度或 2 維度。零維度 geometries (如 Point 和 MultiPoint) 沒有長度或區域。一維度物件 (如 LineString, CircularString, CompoundCurve 和 MultiLineString) 具有長度。二維度執行個體 (如 Polygon、CurvePolygon 和 MultiPolygon) 具有區域和長度。空的執行個體將會報告 -1 的維度，而 GeometryCollection 則會報告與其內容類型相依的區域。

傳回執行個體的維度
STDimension

傳回執行個體的長度
STLength

傳回執行個體的區域
STArea

空白

空geometry 的實例沒有任何點。空的 LineString, CircularString、CompoundCurve 和 MultiLineString 執行個體的長度是零。空的 Polygon、CurvePolygon 和 MultiPolygon 執行個體的區域是 0。

判斷執行個體是否為空的
STIsEmpty。

簡單

geometry若要讓實例的簡單，它必須符合這兩個需求：

此例項的每一個圖形都不能自己相交 (除了在它的端點上以外)。
此例項的兩個圖形不能在非兩者界限內的點上彼此相交。

注意

空的幾何一定是簡單的幾何。

判斷執行個體是否為簡單
STIsSimple。

界限、內部和外部

實例 的內部geometry 是實例所佔用的空間，而外部則是未佔用的空間。

「界限」 (Boundary) 是由 OGC 定義如下：

Point 和 MultiPoint 執行個體沒有界限。
LineString 和 MultiLineString 界限是由起點和終點所組成，移除發生偶數次數的點。

DECLARE @g geometry;  
SET @g = geometry::Parse('MULTILINESTRING((0 1, 0 0, 1 0, 0 1), (1 1, 1 0))');  
SELECT @g.STBoundary().ToString();

Polygon 或 MultiPolygon 執行個體的界限是它的環形集合。

DECLARE @g geometry;  
SET @g = geometry::Parse('POLYGON((0 0, 3 0, 3 3, 0 3, 0 0), (1 1, 1 2, 2 2, 2 1, 1 1))');  
SELECT @g.STBoundary().ToString();

傳回執行個體的界限
STBoundary

範圍

實例的信封也稱為周框方塊，是由實例的 geometry 最小和最大 (X，Y) 座標所構成的座標軸對齊矩形。

傳回執行個體的範圍
STEnvelope

終止

封閉geometry 實例是一個圖形，其起點和終點相同。 Polygon 執行個體視為封閉式。 Point 執行個體視為非封閉式。

環形是簡單、封閉的 LineString 執行個體。

判斷執行個體是否為封閉
STIsClosed

判斷執行個體是否為環形
STIsRing

傳回 Polygon 執行個體的外部環形
STExteriorRing

傳回 Polygon 中的內部環形數
STNumInteriorRing

傳回 Polygon 的指定內部環形
STInteriorRingN

空間參考識別碼 (SRID)

空間參考識別碼 (SRID) 是用來指定代表 geometry 執行個體之座標系統的識別碼。具有不同 SRID 的兩個執行個體無法進行比較。

設定或傳回執行個體的 SRID
STSrid

這個屬性可以修改。

判斷 geometry 執行個體之間的關聯性

geometry 資料類型提供許多內建方法，您可以使用這些方法來判斷兩個 geometry 執行個體之間的關聯性。

判斷兩個執行個體是否組成相同的點集合
STEquals

判斷兩個執行個體是否不相交
STDisjoint

判斷兩個執行個體是否相交
STIntersects

判斷兩個執行個體是否接觸
STTouches

判斷兩個執行個體是否重疊
STOverlaps

判斷兩個執行個體是否交叉
STCrosses

判斷某個執行個體是否在另一個執行個體內
STWithin

判斷某個執行個體是否包含另一個執行個體
STContains

判斷某個執行個體是否與另一個執行個體重疊
STOverlaps

判斷兩個執行個體在空間上是否相關
STRelate

判斷兩個 geometry 內點與點之間的最短距離
STDistance

geometry 執行個體預設為零 SRID

SQL Server 中實例的預設 SRID geometry 為 0。有了 geometry 空間資料，執行計算時並不需要空間執行個體的特定 SRID；因此，執行個體可位於未定義的平面空間內。若要在資料類型方法的計算 geometry 中指出未定義的平面空間，SQL Server Database Engine 會使用 SRID 0。

範例

下列兩個範例示範如何加入及查詢幾何資料。

第一個範例會建立具有識別資料行及 geometry 資料行 GeomCol1的資料表。第三個資料行會將 geometry 資料行轉譯成它的開放地理空間協會 (Open Geospatial Consortium，OGC) 已知的文字 (Well-Known Text，WKT) 表示法，並使用 STAsText() 方法。然後會插入兩個資料列：一個資料列包含 LineString 的 geometry執行個體，另一個資料列包含 Polygon 執行個體。

IF OBJECT_ID ( 'dbo.SpatialTable', 'U' ) IS NOT NULL   
    DROP TABLE dbo.SpatialTable;  
GO  

CREATE TABLE SpatialTable   
    ( id int IDENTITY (1,1),  
    GeomCol1 geometry,   
    GeomCol2 AS GeomCol1.STAsText() );  
GO  

INSERT INTO SpatialTable (GeomCol1)  
VALUES (geometry::STGeomFromText('LINESTRING (100 100, 20 180, 180 180)', 0));  

INSERT INTO SpatialTable (GeomCol1)  
VALUES (geometry::STGeomFromText('POLYGON ((0 0, 150 0, 150 150, 0 150, 0 0))', 0));  
GO

第二個範例使用 STIntersection() 方法傳回之前插入之兩個 geometry 執行個體相交的點。

DECLARE @geom1 geometry;  
DECLARE @geom2 geometry;  
DECLARE @result geometry;  

SELECT @geom1 = GeomCol1 FROM SpatialTable WHERE id = 1;  
SELECT @geom2 = GeomCol1 FROM SpatialTable WHERE id = 2;  
SELECT @result = @geom1.STIntersection(@geom2);  
SELECT @result.STAsText();

另請參閱

空間資料 (SQL Server)

共用方式為

建立、建構及查詢幾何執行個體

建立或建構新的 geometry 執行個體

從現有的執行個體建立新的 geometry 執行個體

從已知的文字輸入建構 geometry 執行個體

從已知的二進位輸入建構 geometry 執行個體

從 GML 文字輸入建構 geometry 執行個體

從 geometry 執行個體傳回已知的文字和已知的二進位

查詢 geometry 執行個體的屬性和行為

有效性、執行個體類型和 GeometryCollection 資訊

點數

尺寸

空白

簡單

界限、內部和外部

範圍

終止

空間參考識別碼 (SRID)

判斷 geometry 執行個體之間的關聯性

geometry 執行個體預設為零 SRID

範例

另請參閱

其他資源