STDistance (geography 資料類型)
傳回 geography 例項中的點與另一個 geography 例項中的點之間的最短距離。
[!附註]
STDistance() 會傳回兩個地理位置類型之間的最短 LineString。 這是地理距離的近似值。 通用地球模型上 STDistance() 與實際地理距離的偏差不大於 .25%。 這可避免地理類型中長度與距離細微差異的混淆。
語法
.STDistance ( other_geography )
引數
- other_geography
這是另一個 geography 例項，用來測量它與 STDistance() 叫用所在之例項之間的距離。 如果 other_geography 是空的集合，STDistance() 會傳回 Null。
傳回類型
SQL Server 傳回類型：float
CLR 傳回類型：SqlDouble
備註
如果 geography 執行個體的空間參考識別碼 (SRID) 不相符，STDistance() 一定會傳回 Null。
[!附註]
geography 資料類型上計算區域或距離的方法將會根據此方法中使用之執行個體的 SRID，而傳回不同的結果。 如需有關 SRID 的詳細資訊，請參閱＜空間參考識別碼 (SRID)＞。
範例
下列範例會求得兩個 geography 執行個體之間的距離。
DECLARE @g geography;
DECLARE @h geography;
SET @g = geography::STGeomFromText('LINESTRING(-122.360 47.656, -122.343 47.656)', 4326);
SET @h = geography::STGeomFromText('POINT(-122.34900 47.65100)', 4326);
SELECT @g.STDistance(@h);