创建、构造和查询地理实例

适用于:SQL ServerAzure SQL 数据库Azure SQL 托管实例Microsoft Fabric 中的 SQL 分析终结点Microsoft Fabric 中的仓库Microsoft Fabric 中的 SQL 数据库

地理空间 geography 数据类型表示圆形地球坐标系中的数据。 此类型在 SQL Server 中作为 .NET 公共语言运行时 (CLR) 数据类型实现。 SQL Server geography 数据类型用于存储椭球体(地球表面)数据,例如 GPS 纬度和经度坐标。

geography 类型已进行预定义,可在每个数据库中使用。 你可以创建 geography 类型的表列并对 geography 数据进行操作,就像使用其他系统提供的数据类型一样。

创建或构建新的地域实例

从现有实例创建新的地域实例

geography 数据类型提供了许多内置方法,你可以使用这些方法基于现有实例创建新的 geography 实例。

在地域周围创建缓冲区
STBuffer(geography 数据类型)

围绕地理对象创建缓冲区,并允许一定误差
BufferWithTolerance(geography 数据类型)

基于两个地理图形实例的交集创建地理图形
STIntersection(地理数据类型)

从两个地理位置实例的并集创建地理位置
STUnion(地理位置数据类型)

根据一个地理区域中未与另一个地理区域重叠的点来创建地理区域
STDifference(地理位置数据类型)

根据已知文本 (WKT) 输入构建地理实例

geography 数据类型提供了若干种用开放地理空间联盟 (OGC) WKT 表示形式生成地域的内置方法。 WKT 标准是一种允许地域数据以文本形式交换的文本字符串。

用 WKT 输入构造任意类型的地域实例
STGeomFromText (地理数据类型)

分析(地理数据类型)

根据 WKT 输入构建地理点 (Point) 实例
STPointFromText(geography 数据类型)

根据 WKT 输入构建地理多点 (MultiPoint) 实例
STMPointFromText(geography 数据类型)

根据 WKT 输入构建地理线串 (LineString) 实例
STLineFromText(geography 数据类型)

用 WKT 输入构造地域 MultiLineString 实例
STMLineFromText(geography 数据类型)

根据 WKT 输入构建地理多边形 (Polygon) 实例
STPolyFromText(地理数据类型)

根据 WKT 输入构建地理 MultiPolygon 实例
STMPolyFromText(地理数据类型)

根据 WKT 输入构建地理 GeometryCollection 实例
STGeomCollFromText(geography 数据类型)

根据标准二进制文本(WKB)输入构建地理实例

WKB 是由 OGC 指定的二进制格式,允许 在客户端应用程序和 SQL 数据库之间交换 Geography 数据。 以下函数接受 WKB 输入,并据此构造 geography 实例:

用 WKB 输入构造任意类型的地域实例
STGeomFromWKB(geography 数据类型)

根据 WKB 输入构建地理 Point 实例
STPointFromWKB(地理数据类型)

根据 WKB 输入构建地理 MultiPoint 实例
STMPointFromWKB (geography 数据类型)

用 WKB 输入构造地域 LineString 实例
STLineFromWKB(geography 数据类型)

根据 WKB 输入构建地理 MultiLineString 实例
STMLineFromWKB(地理数据类型)

根据 WKB 输入构建地理 Polygon 实例
STPolyFromWKB(geography 数据类型)

根据 WKB 输入构建地理 MultiPolygon 实例
STMPolyFromWKB(geography 数据类型)

根据 WKB 输入构建地理 GeometryCollection 实例
STGeomCollFromWKB(地理数据类型) STGeomCollFromWKB(地理数据类型)

从 GML 文本输入构造地理实例

geography 数据类型提供了一种用 GML( geography 实例的 XML 表示形式)生成 geography 实例的方法。 SQL Server 支持 GML 的子集。

有关地理标记语言的更多信息,请参见OGC规范: OGC规范,地理标记语言。

用 GML 输入构造任意类型的地域实例
GeomFromGML(Geography 数据类型)

从地理实例返回已知文本和已知二进制文件

可以使用以下方法返回 WKT 或 WKB 格式的 geography 实例:

返回地理实例的 WKT 表示形式
STAsText(geography数据类型)

ToString(geography 数据类型)

返回包括任何 Z 值和 M 值的地域实例的 WKT 表示形式
AsTextZM(地理数据类型)

返回地理实例的 WKB 表示形式
STAsBinary(地理数据类型)

返回地域实例的 GML 表示形式
AsGml - 地理数据类型

查询地理实例的属性和行为

所有 geography 实例都有很多可以通过 SQL Server 提供的方法进行检索的属性。 以下主题定义了地理类型的属性和行为,以及用于查询每种类型的方法。

有效性、实例类型和几何集合信息

构造 geography 实例后,就可以使用以下方法返回实例类型,或者,如果它是 GeometryCollection 实例,则返回特定的 geography 实例。

返回地域的实例类型
STGeometryType(geography 数据类型)

确定地域是否为给定的实例类型
InstanceOf(地理数据类型)

用于判断地理实例是否符合其实例类型的格式规范
STNumGeometries(geography 数据类型)

返回 GeometryCollection 实例中的特定地域
STGeometryN(地理数据类型) STGeometryN(地理数据类型)

点数

所有非空 geography 实例均由 点 构成。 这些点代表地球上的纬度和经度坐标,地理实例即绘制于这些坐标上。 geography 数据类型提供了许多用于查询实例点的内置方法。

返回构成实例的点数。
STNumPoints(geography 数据类型)

返回实例中的特定点
STPointN(geometry 数据类型)

返回实例的起始点
STStartPoint(geography 数据类型)

返回实例的终结点
STEndPoint(地理数据类型)

Dimension

非空 geography 实例可以为零维、一维或二维。 零维 geography 实例(如 Point 和 MultiPoint)没有长度或面积。 一维对象(如 LineString、CircularString、 CompoundCurve 和 MultiLineString)有长度。 二维实例(如 Polygon、CurvePolygon 和 MultiPolygon)有面积和长度。 空实例的维度为 -1,GeometryCollection 的维度则为其所含内容中的最高维度。

返回实例的维度
STDimension(地理数据类型)

返回实例的长度
STLength(geography 数据类型)

返回实例的面积
STArea(地理数据类型)

Empty

空geography 实例没有任何点。 空的 LineString, CircularString、 CompoundCurve 和 MultiLineString 实例的长度为 0。 空的 Polygon, CurvePolygon 和 MultiPolygon 实例的面积为 0。

确定实例是否为空
STIsEmpty(geography 数据类型)

Closure

闭合的 geography 实例是指起始点和终点相同的图形。 Polygon 实例被视为闭合的。 Point 实例不是闭合的。

环是一个简单、闭合的 LineString 实例。

确定实例是否闭合
STIsClosed(geography 数据类型)

返回多边形实例中的环数
NumRings(地理数据类型)

返回地域实例的指定环
RingN(地理数据类型)

空间参考 ID (SRID)

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

设置或返回实例的 SRID
STSrid(geography 数据类型)

此属性可以进行修改。

确定地理实例之间的关系

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

确定两个实例是否包含相同的点集
STEquals(几何数据类型)

确定两个实例是否不相接
STDisjoint(geometry 数据类型)

确定两个实例是否相交
STIntersects(几何数据类型)

确定两个实例的交点
STIntersection(地理数据类型)

确定两个地域实例中点之间的最短距离
STDistance(geometry 数据类型)

确定两个地域实例之间点的不同
STDifference(地理位置数据类型)

用于推导一个地理实例与另一个实例之间的对称差,即唯一点
STSymDifference(geography 数据类型)

geography 实例必须使用受支持的 SRID

SQL Server 支持基于 EPSG 标准的 SRID。 在执行计算或将方法与地理空间数据一起使用时,必须使用 geography 实例的 SQL Server 支持的 SRID。 SRID 必须与 sys.spatial_reference_systems 目录视图中显示的 SRID 中的一个匹配。 如前所述,在使用 geography 数据类型对空间数据执行计算时,结果将取决于在创建数据时使用的是哪个椭圆体,因为为每个椭圆体都分配了一个特定空间引用标识符 (SRID)。

对 geography 实例使用方法时,SQL Server 使用默认 SRID 4326,它将映射到 WGS 84 空间引用系统。 如果要使用 WGS 84(或 SRID 4326)之外的某个空间引用系统中的数据,你需要确定地域空间数据的特定 SRID。

Remarks

几何和地理空间类型不能在 Microsoft Fabric 中的 SQL 分析终结点 或 Microsoft Fabric 中的 Warehouse 中用作表列。

Examples

以下示例说明如何添加和查询地理数据。

示例 A.

此示例创建了一个带有标识列和 geography 列 GeogCol1 的表。 第三列将 geography 列呈现为其开放地理空间信息联盟 (OGC) 熟知文本 (WKT) 表示形式,并使用 STAsText() 方法。 接下来将插入两行:一行包含 LineString 类型的 geography实例,一行包含 Polygon 实例。

IF OBJECT_ID ( 'dbo.SpatialTable', 'U' ) IS NOT NULL   
DROP TABLE dbo.SpatialTable;  
GO  
  
CREATE TABLE SpatialTable   
  ( id int IDENTITY (1,1),  
    GeogCol1 geography,   
    GeogCol2 AS GeogCol1.STAsText()
   );  
GO  
  
INSERT INTO SpatialTable (GeogCol1)  
VALUES (geography::STGeomFromText('LINESTRING(-122.360 47.656, -122.343 47.656)', 4326));  
  
INSERT INTO SpatialTable (GeogCol1)  
VALUES (geography::STGeomFromText('POLYGON((-122.358 47.653, -122.348 47.649, -122.348 47.658, -122.358 47.658, -122.358 47.653))', 4326));  
GO  

示例 B.

此示例使用 STIntersection() 方法返回此前插入的两个 geography 实例相交的点。

DECLARE @geog1 geography;  
DECLARE @geog2 geography;  
DECLARE @result geography;  
  
SELECT @geog1 = GeogCol1 FROM SpatialTable WHERE id = 1;  
SELECT @geog2 = GeogCol1 FROM SpatialTable WHERE id = 2;  
SELECT @result = @geog1.STIntersection(@geog2);  
SELECT @result.STAsText();