ST_DWithin
ST_DWithin은 두 입력 지오메트리 값의 2D 프로젝션 간 유클리드 거리가 임계값보다 크지 않은 경우 true를 반환합니다.
구문
ST_DWithin(geom1, geom2, threshold)
인수
- geom1
-
GEOMETRY데이터 형식의 값 또는GEOMETRY형식으로 계산되는 표현식입니다. - geom2
-
GEOMETRY데이터 형식의 값 또는GEOMETRY형식으로 계산되는 표현식입니다. - threshold
-
DOUBLE PRECISION데이터 형식의 값입니다. 이 값은 입력 인수 단위입니다.
반환 타입
BOOLEAN
geom1 또는 geom2가 null이면 null이 반환됩니다.
threshold가 음수이면 오류가 반환됩니다.
geom1과 geom2의 SRID(공간 참조 시스템 식별자) 값이 같지 않으면 오류가 반환됩니다.
geom1 또는 geom2가 지오메트리 컬렉션인 경우 오류가 반환됩니다.
예제
다음 SQL은 두 다각형 사이의 거리가 5단위 이내인지 확인합니다.
SELECT ST_DWithin(ST_GeomFromText('POLYGON((0 2,1 1,0 -1,0 2))'), ST_GeomFromText('POLYGON((-1 3,2 1,0 -3,-1 3))'),5);
st_dwithin
-----------
true
