ShortestLineTo (тип данных geography)
Возвращает экземпляр LineString с двумя точками, представляющий кратчайшее расстояние между двумя экземплярами geography. Длина возвращаемого экземпляра LineString равна расстоянию между двумя экземплярами geography.
Синтаксис
.ShortestLineTo ( geography_other )
Аргументы
- geography_other
Указывает второй экземпляр geography, кратчайшее расстояние до которого пытается определить вызывающий экземпляр geography.
Типы возвращаемых данных
Возвращаемый тип SQL Server: geography
Возвращаемый тип CLR: SqlGeography
Замечания
Этот метод возвращает экземпляр LineString с двумя конечными точками, лежащими на границах двух сравниваемых непересекающихся экземпляров geography. Длина возвращаемого экземпляра LineString равна кратчайшему расстоянию между двумя экземплярами geography. Пустой экземпляр LineString возвращается, когда два экземпляра geography пересекаются друг с другом.
Примеры
А.Вызов функции ShortestLineTo() для непересекающихся экземпляров
В этом примере ищется кратчайшее расстояние между экземпляром CircularString и экземпляром LineString и возвращается экземпляр LineString, соединяющий эти две точки:
DECLARE @g1 geography = 'CIRCULARSTRING(-122.358 47.653, -122.348 47.649, -122.348 47.658, -122.358 47.658, -122.358 47.653)';
DECLARE @g2 geography = 'LINESTRING(-119.119263 46.183634, -119.273071 47.107523, -120.640869 47.569114, -122.200928 47.454094)';
SELECT @g1.ShortestLineTo(@g2).ToString();
Б.Вызов функции ShortestLineTo() для пересекающихся экземпляров
Этот пример возвращает пустой экземпляр LineString, поскольку экземпляр LineString пересекает экземпляр CircularString:
DECLARE @g1 geography = 'CIRCULARSTRING(-122.358 47.653, -122.348 47.649, -122.348 47.658, -122.358 47.658, -122.358 47.653)';
DECLARE @g2 geography = 'LINESTRING(-119.119263 46.183634, -119.273071 47.107523, -120.640869 47.569114, -122.348 47.649, -122.681 47.655)';
SELECT @g1.ShortestLineTo(@g2).ToString();