STDistance（geometry 数据类型）

  • 项目

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

返回一个 geometry 实例中的点与另一个 geometry 实例中的点之间的最短距离。

语法

  
.STDistance ( other_geometry )

注意

若要查看 SQL Server 2014 (12.x) 及更早版本的 Transact-SQL 语法，请参阅早期版本文档。

自变量

other_geometry
另一个 geometry 实例，将度量该实例与调用 STDistance() 的实例之间的距离。 如果 other_geometry 为空集，则 STDistance() 返回 null。

返回类型

SQL Server 返回类型：float

CLR 返回类型：SqlDouble

注解

如果 geometry 实例的空间引用 ID (SRID) 不匹配，则 STDistance() 始终返回 null。

示例

DECLARE @g geometry;  
DECLARE @h geometry;  
SET @g = geometry::STGeomFromText('POLYGON((0 0, 2 0, 2 2, 0 2, 0 0))', 0);  
SET @h = geometry::STGeomFromText('POINT(10 10)', 0);  
SELECT @g.STDistance(@h);

另请参阅

空间索引概述
几何图形实例上的 OGC 方法