STLength(geography 데이터 형식)

geography 인스턴스 또는 GeometryCollection 내의 geography 인스턴스에 있는 요소의 총 길이를 반환합니다.

구문

.STLength ( )

반환 형식

SQL Server 반환 형식: float

CLR 반환 형식: SqlDouble

주의

geography 인스턴스가 닫힌 경우 해당 길이는 인스턴스의 총 둘레 길이로 계산됩니다. 즉, 모든 다각형의 길이는 해당 둘레의 길이이며 점의 길이는 0입니다. GeometryCollection의 길이는 컬렉션 내에 포함된 모든 geography 인스턴스의 길이 합계를 계산하여 구합니다.

STLength()는 유효한 LineString과 잘못된 LineString 둘 다에서 작동합니다. 일반적으로 LineString은 겹치는 세그먼트로 인해 유효하지 않으며, 이는 부정확한 GPS 추적 같은 잘못된 부분 때문에 발생할 수 있습니다. STLength()는 겹친 세그먼트나 잘못된 세그먼트를 제거하지 않습니다. STLength()는 반환하는 길이 값에 겹치는 세그먼트 및 잘못된 세그먼트를 포함합니다. MakeValid() 메서드는 LineString에서 겹치는 세그먼트를 제거할 수 있습니다.

다음 예에서는 LineString 인스턴스를 만들고 STLength()를 사용하여 인스턴스의 길이를 구합니다.

DECLARE @g geography;
SET @g = geography::STGeomFromText('LINESTRING(-122.360 47.656, -122.343 47.656)', 4326);
SELECT @g.STLength();

참고 항목

관련 자료

geography 인스턴스의 OGC 메서드