ShortestLineTo(geography 데이터 형식)

적용 대상: SQL ServerAzure SQL Database Azure SQL Managed Instance

두 지리 인스턴스 간의 가장 짧은 거리를 나타내는 두 점이 있는 LineString 인스턴스를 반환합니다. 반환되는 LineString 인스턴스의 길이는 두 지리 인스턴스 사이의 거리입니다.

Syntax

  
.ShortestLineTo ( geography_other )  

참고 항목

SQL Server 2014(12.x) 이전 버전의 Transact-SQL 구문을 보려면 이전 버전 설명서를 참조하세요.

인수

geography_other
호출하는 지리 인스턴스가 가장 짧은 거리를 확인하려고 하는 두 번째 지리 인스턴스를 지정합니다.

반환 형식

SQL Server 반환 형식: geography

CLR 반환 형식: SqlGeography

설명

이 메서드는 비교되는 교차하지 않는 두 지리 인스턴스의 테두리에 엔드포인트가 있는 LineString 인스턴스를 반환합니다. 반환되는 LineString 의 길이는 두 지리 인스턴스 간의 가장 짧은 거리와 같습니다. 두 지리 인스턴스가 서로 교차하면 빈 LineString 인스턴스가 반환됩니다.

예제

A. 교차하지 않는 인스턴스에서 ShortestLineTo() 호출

이 예제에서는 인스턴스와 LineString 인스턴스 사이의 CircularString 가장 짧은 거리를 찾고 두 지점을 연결하는 인스턴스를 반환 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();

B. 교차하는 인스턴스에서 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();

참고 항목

지리 인스턴스의 확장 메서드
ShortestLineTo(geometry 데이터 형식)