STDistance (geometry データ型)

  • [アーティクル]

適用対象:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceMicrosoft Fabric の SQL 分析エンドポイントMicrosoft Fabric のウェアハウス

任意の geometry インスタンスの地点と別の geometry インスタンスの地点との最短距離を返します。

構文

  
.STDistance ( other_geometry )

Note

SQL Server 2014 (12.x) 以前のバージョンの Transact-SQL 構文を確認するには、以前のバージョンのドキュメントを参照してください。

引数

other_geometry
STDistance() を呼び出したインスタンスまでの距離が測定される、別の geometry インスタンスです。 other_geometry が空のセットである場合、STDistance() は NULL を返します。

戻り値の型

SQL Server 戻り値の型: float

CLR の戻り値の型: SqlDouble

注釈

geometry インスタンスの SRID (spatial reference ID) が一致しない場合、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);

参照

空間インデックスの概要
Geometry インスタンスの OGC メソッド