ST_LineInterpolatePoint

ST_LineInterpolatePoint는 선의 시작 부분에서 분수 거리에 있는 선을 따라 점을 반환합니다.

점 동등성을 판별하기 위해 ST_LineInterpolatePoint는 입력 지오메트리의 2D 프로젝션에서 작동합니다. 입력 지오메트리가 비어 있으면 해당 복사본이 입력과 동일한 차원으로 반환됩니다. 3DZ, 3DM 및 4D 지오메트리의 경우 z 또는 m 좌표는 점이 있는 세그먼트의 z 또는 m 좌표의 평균입니다.

구문

ST_LineInterpolatePoint(geom, fraction)

인수

geom

GEOMETRY 데이터 형식의 값 또는 GEOMETRY 형식으로 계산되는 표현식입니다. 하위 유형은 LINESTRING입니다.

fraction

선에 대한 라인스트링을 따라 점의 위치를 나타내는 DOUBLE PRECISION 데이터 형식의 값입니다. 값은 0~1(포함) 범위의 분수입니다.

반환 타입

POINT 하위 유형의 GEOMETRY입니다.

geom 또는 fraction이 null이면 null이 반환됩니다.

geom이 비어 있으면 빈 점이 반환됩니다.

반환된 지오메트리의 공간 참조 시스템 식별자(SRID) 값은 입력 지오메트리의 SRID 값입니다.

fraction이 범위를 벗어나면 오류가 반환됩니다.

geom이 라인스트링이 아니면 오류가 반환됩니다.

예제

다음 SQL은 라인스트링을 따라 중간 점을 반환합니다.

SELECT ST_AsEWKT(ST_LineInterpolatePoint(ST_GeomFromText('LINESTRING(0 0, 5 5, 7 7, 10 10)'), 0.50));

st_asewkt
-----------
 POINT(5 5)      

다음 SQL은 라인스트링을 따라 90% 점을 반환합니다.

SELECT ST_AsEWKT(ST_LineInterpolatePoint(ST_GeomFromText('LINESTRING(0 0, 5 5, 7 7, 10 10)'), 0.90));

st_asewkt
-----------
 POINT(9 9)