STDistance (geometry 資料類型)

  • 發行項

適用於：Microsoft Fabric 中 Microsoft Fabric倉儲中的 SQL ServerAzure SQL 資料庫 Azure SQL 受控執行個體 SQL 分析端點

傳回 geometry 執行個體中的點與另一個 geometry 執行個體中的點之間的最短距離。

Syntax

  
.STDistance ( other_geometry )

注意

若要檢視 SQL Server 2014 （12.x） 和舊版的 Transact-SQL 語法，請參閱 舊版檔。

引數

other_geometry
這是另一個geometry 執行個體，用來測量它與叫用 STDistance() 所在之執行個體之間的距離。 如果 other_geometry 是空的集合，STDistance() 會傳回 Null。

傳回型別

SQL Server 傳回類型：float

CLR 傳回類型：SqlDouble

備註

如果 geometry 執行個體的空間參考識別碼 (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 方法