创建、构造和查询几何图形实例

非空 geometry 实例可以为零维、一维或二维。零维 geometry（如 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 实例的“内部”是指由实例占用的空间，而“外部”是指未占用的空间。

“边界” 由 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

返回多边形实例的外环
STExteriorRing

返回多边形的内环数
STNumInteriorRing

返回多边形的指定内环
STInteriorRingN

空间引用标识符 (SRID)

空间引用标识符 (SRID) 是指定 geometry 实例所在的坐标系的标识符。两个拥有不同 SRID 的实例是不可比的。

设置或返回实例的 SRID
STSrid

注意

此属性可以进行修改。

确定几何图形实例之间的关系

geometry 数据类型提供了许多内置方法，你可以使用这些方法确定两个 geometry 实例之间的关系。

确定两个实例是否包含相同的点集
STEquals

确定两个实例是否不相接
STDisjoint

确定两个实例是否相交
STIntersects

确定两个实例是否接触
STTouches

确定两个实例是否重叠
STOverlaps

确定两个实例是否交叉
STCrosses

确定某个实例是否在另一个实例内部
STWithin

确定某个实例是否包含另一个实例
STContains

确定某个实例是否与另一个实例重叠
STOverlaps

确定两个实例是否存在空间关系
STRelate

确定两个几何图形中的点之间的最短距离
STDistance

几何图形实例默认 SRID 为零

SQL Server 中 geometry 实例的默认 SRID 为 0。利用 geometry 空间数据，执行计算是不需要空间实例的指定 SRID 的；因此，实例可驻留在未定义的平面空间。要在 geometry 数据类型方法的计算中指明未定义的平面空间，SQL Server 数据库引擎使用 SRID 0。

示例

以下两个示例显示了如何添加和查询几何图形数据。

示例 A。

此示例创建了一个带有标识列和 geometry 列 GeomCol1 的表。第三列将 geometry 列呈现为其开放地理空间信息联盟 (OGC) 熟知文本 (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();

另请参阅

空间数据 (SQL Server)

通过

创建、构造和查询几何图形实例

创建或构建新的几何图形实例

从现有实例创建新的几何图形实例

从熟知文本输入构造几何图形实例

从熟知二进制输入构造几何图形实例

用 GML 文本输入构造几何图形实例

从几何图形实例返回熟知文本和熟知二进制

查询几何图形实例的属性和行为

有效性、实例类型和 GeometryCollection 信息

点数

维度

空

简单