STDistance (тип данных geometry)

Статья
11/15/2023

Применяется к:SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure Управляемый экземпляр SQL Azure sql analytics в хранилище Microsoft Fabricв Microsoft Fabric

Возвращает наименьшее расстояние от точки в экземпляре geometry до точки в другом экземпляре geometry.

Синтаксис

  
.STDistance ( other_geometry )

Примечание.

Сведения о синтаксисе Transact-SQL для SQL Server 2014 (12.x) и более ранних версиях см . в документации по предыдущим версиям.

Аргументы

other_geometry
Другой экземпляр geometry, от которого измеряется расстояние до экземпляра, где вызван метод STDistance(). Если other_geometry является пустым множеством, метод STDistance() возвращает значение NULL.

Типы возвращаемых данных

Тип возвращаемого значения SQL Server: float

Тип возвращаемых данных CLR: SqlDouble

Замечания

Метод STDistance() всегда возвращает значение NULL, если идентификаторы пространственных ссылок (SRID) экземпляров geometry не совпадают.

Примеры

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 в экземплярах Geometry