STDistance (географический тип данных)

  • Статья

Применимо к:SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure

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

Примечание.

STDistance() возвращает самое короткое значение LineString между двумя типами geography. Это приблизительное значение, соответствующее геодезическому расстоянию. Отклонение значения STDistance() на простых моделях Земли от точного геодезического расстояния составляет не более 0,25 %. Это позволяет избежать путаницы, когда речь заходит о незначительной разнице между длиной и расстоянием в геодезических типах.

Синтаксис

  
.STDistance ( other_geography )

Примечание.

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

Аргументы

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

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

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

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

Замечания

Результат выражается в единице измерения, определенной идентификатором пространственной ссылки (SRID) пространственных данных. STDistance() всегда возвращает значение NULL, если у экземпляров geography не совпадают идентификаторы пространственных ссылок (SRID).

Примечание.

Методы, вызываемые для типа данных 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);

См. также

Методы OGC в экземплярах Geography