建立、建構和查詢 geometry 實例

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

傳回執行個體的維度
STDimension （geometry 數據類型）

傳回執行個體的長度
STLength (geometry 資料類型)

傳回執行個體的區域
STArea (geometry 資料類型)

空白

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

判斷執行個體是否為空的
STIsEmpty （geometry 資料類型）。

簡單

如果要讓執行個體的 geometry 為 「簡單」(simple)，它必須符合以下兩個需求：

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

注意

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

判斷執行個體是否為簡單
STIsSimple （geometry 資料類型）。

界限、內部和外部

geometry 執行個體的 「內部」 (Interior) 是此執行個體所佔據的空間，而 「外部」 (Exterior) 則是未佔據它的空間。

「界限」 (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 數據類型）

範圍

geometry 執行個體的 「範圍」 (Envelope) (也稱為 「週框方塊」(Bounding Box)) 是執行個體的最小和最大座標 (X,Y) 組成的座標軸對齊矩形。

傳回執行個體的範圍
STEnvelope （geometry 數據類型）

終止

「封閉式」geometry 執行個體是起始點與結束點相同的圖形。 Polygon 執行個體視為封閉式。 Point 執行個體視為非封閉式。

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

判斷執行個體是否為封閉
STIsClosed (geometry 資料類型)

判斷執行個體是否為環形
STIsRing (geometry 資料類型)

傳回 Polygon 執行個體的外部環形
STExteriorRing (geometry 資料類型)

傳回 Polygon 中的內部環形數
STNumInteriorRing (geometry 資料類型)

傳回 Polygon 的指定內部環形
STInteriorRingN (geometry 資料類型)

空間參考識別碼（SRID）

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

設定或傳回執行個體的 SRID
STSrid (geometry 資料類型)

注意

這個屬性可以修改。

判斷 geometry 實例之間的關聯性

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

判斷兩個執行個體是否組成相同的點集合
STEquals (geometry 資料類型)

判斷兩個執行個體是否不相交
STDisjoint (geometry 資料類型)

判斷兩個執行個體是否相交
STIntersects (geometry 資料類型)

判斷兩個執行個體是否接觸
STTouches （geometry 數據類型）

判斷兩個執行個體是否重疊
STOverlaps （geometry 數據類型）

判斷兩個執行個體是否交叉
STCrosses （geometry 數據類型）

判斷某個執行個體是否在另一個執行個體內
STWithin （geometry 數據類型）

判斷某個執行個體是否包含另一個執行個體
STContains （geometry 數據類型）

判斷某個執行個體是否與另一個執行個體重疊
STOverlaps （geometry 數據類型）

判斷兩個執行個體在空間上是否相關
STRelate （geometry 數據類型）

判斷兩個 geometry 內點與點之間的最短距離
STDistance (geometry 資料類型)

geometry 實例預設為零 SRID

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

備註

geometry 和 geography 類型不能當做 Microsoft Fabric 中 SQL 分析端點中的數據表數據行，或Microsoft Fabric 中的倉儲。

範例

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

範例 A。

此範例會建立具有識別資料行及 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

範例 B.

此範例會使用 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();

空間數據

共用方式為

建立、建構和查詢 geometry 實例

建立或建構新的 geometry 實例

從現有的實例建立新的 geometry 實例

從已知文字輸入建構幾何實例

從已知的二進位輸入建構幾何實例

從 GML 文字輸入建構幾何實例

從 geometry 實例傳回已知文字和已知二進位檔

查詢 geometry 實例的屬性和行為

有效性、實例類型和 GeometryCollection 資訊

點數

尺寸

空白

簡單

界限、內部和外部

範圍

終止

空間參考識別碼（SRID）

判斷 geometry 實例之間的關聯性

geometry 實例預設為零 SRID

備註

範例

範例 A。

範例 B.

意見反應

其他資源

共用方式為

建立、建構和查詢 geometry 實例

建立或建構新的 geometry 實例

從現有的實例建立新的 geometry 實例

從已知文字輸入建構幾何實例

從已知的二進位輸入建構幾何實例

從 GML 文字輸入建構幾何實例

從 geometry 實例傳回已知文字和已知二進位檔

查詢 geometry 實例的屬性和行為

有效性、實例類型和 GeometryCollection 資訊

點數

尺寸

空白

簡單

界限、內部和外部

範圍

終止

空間參考識別碼 （SRID）

判斷 geometry 實例之間的關聯性

geometry 實例 預設為零 SRID

備註

範例

範例 A。

範例 B.

相關內容

意見反應

其他資源

空間參考識別碼（SRID）

geometry 實例預設為零 SRID