STLength(geometry 데이터 형식)
geometry 인스턴스에 있는 요소의 총 길이를 반환합니다.
구문
.STLength ( )
반환 형식
SQL Server 반환 형식: float
CLR 반환 형식: SqlDouble
주의
geometry 인스턴스가 닫힌 경우 해당 길이는 인스턴스의 총 둘레 길이로 계산됩니다. 즉, 모든 다각형의 길이는 해당 둘레의 길이이며 점의 길이는 0입니다. 모든 geometry collection 형식의 길이는 해당 형식의 포함된 geometry 인스턴스 길이의 합계입니다.
STLength()는 유효한 LineString과 잘못된 LineString 둘 다에서 작동합니다. 일반적으로 LineString은 겹치는 세그먼트로 인해 유효하지 않으며, 이는 부정확한 GPS 추적 같은 잘못된 부분 때문에 발생할 수 있습니다. STLength()는 겹친 세그먼트나 잘못된 세그먼트를 제거하지 않습니다. STLength()는 반환하는 길이 값에 겹치는 세그먼트 및 잘못된 세그먼트를 포함합니다. MakeValid() 메서드는 LineString에서 겹치는 세그먼트를 제거할 수 있습니다.
예
다음 예에서는 LineString 인스턴스를 만들고 STLength()를 사용하여 인스턴스의 길이를 구합니다.
DECLARE @g geometry;
SET @g = geometry::STGeomFromText('LINESTRING(0 0, 2 2, 1 0)', 0);
SELECT @g.STLength();