설명

래스터 rastA와 래스터 rastB가 서로 설정된 거리 안에 있을 경우 참을 반환합니다. 밴드 번호를 설정하지 않거나 또는 NULL로 설정할 경우, 확인 작업중 래스터의 볼록 껍질만 고려합니다. 밴드 번호를 설정할 경우, 확인 작업중 값을 가진 (NODATA가 아닌) 픽셀들만 고려합니다.

거리는 래스터들의 공간 참조 시스템이 정의한 단위로 설정됩니다. 이 함수가 제대로 동작하려면, 소스 래스터들이 둘 다 동일한 SRID를 가진, 동일한 좌표 투영체여야 합니다.

	이 피연산자(operand)는 래스터에서 이용할 수도 있는 모든 인덱스를 활용할 것입니다.

	래스터와 도형의 공간 관계성을 확인하려면, ST_DWithin(ST_Polygon(raster), geometry)처럼 래스터에 ST_Polygon 함수를 이용하십시오.

2.1.0 버전부터 사용할 수 있습니다.

예시

SELECT r1.rid, r2.rid, ST_DWithin(r1.rast, 1, r2.rast, 1, 3.14) FROM dummy_rast r1 CROSS JOIN dummy_rast r2 WHERE r1.rid = 2;

 rid | rid | st_dwithin
-----+-----+------------
   2 |   1 | f
   2 |   2 | t
            

참고

ST_Within, ST_DFullyWithin