다음을 통해 공유


ShortestLineTo(geometry 데이터 형식)

적용 대상: Microsoft Fabric의 SQL ServerAzure SQL Database Azure SQL Managed Instance SQL 데이터베이스

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

구문

  
.ShortestLineTo ( geometry_other )  

인수

geometry_other
호출하는 기하 도형 인스턴스가 가장 짧은 거리를 확인하려고 하는 두 번째 기하 도형 인스턴스입니다.

반환 형식

SQL Server 반환 형식: geometry

CLR 반환 형식: SqlGeometry

설명

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

예제

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

이 예제에서는 인스턴스와 LineString 인스턴스 사이의 CircularString 가장 짧은 거리를 찾고 두 지점을 연결하는 인스턴스를 반환 LineString 합니다.

 DECLARE @g1 geometry = 'CIRCULARSTRING(0 0, 1 2.1082, 3 6.3246, 0 7, -3 6.3246, -1 2.1082, 0 0)';  
 DECLARE @g2 geometry = 'LINESTRING(-4 7, 7 10, 3 7)';  
 SELECT @g1.ShortestLineTo(@g2).ToString();

B. 교차하는 인스턴스에서 ShortestLineTo() 호출

이 예제에서는 인스턴스가 인스턴스 LineString 와 교차하므로 빈 LineString 인스턴스를 CircularString 반환합니다.

 DECLARE @g1 geometry = 'CIRCULARSTRING(0 0, 1 2.1082, 3 6.3246, 0 7, -3 6.3246, -1 2.1082, 0 0)';  
 DECLARE @g2 geometry = 'LINESTRING(0 5, 7 10, 3 7)';  
 SELECT @g1.ShortestLineTo(@g2).ToString();

참고 항목

ShortestLineTo(geography 데이터 형식)