ST_DWITHIN

ST_DWITHIN

두 지리 공간 값 사이의 최소 대원 거리(great circle distance)가 지정된 거리 이내인지 판별하는 공간 함수예요. 이내면 TRUE, 아니면 FALSE를 돌려줘요.

출처: 공식 문서

본문

두 점(두 GEOGRAPHY 객체) 사이의 최소 대원 거리가 지정된 거리 이내이면 TRUE를 반환하고, 그렇지 않으면 FALSE를 반환합니다.

매개변수가 점이 아닌 GEOGRAPHY 값(예: 선이나 폴리곤)이면, 두 값의 가장 가까운 두 점 사이의 최소 대원 거리에 기반해 TRUE 또는 FALSE를 반환합니다.

팁 검색 최적화 서비스(search optimization service)를 사용해 이 함수를 호출하는 쿼리의 성능을 개선할 수 있습니다. 자세한 내용은 Search optimization service를 참고하세요.

구문 (Syntax)

ST_DWITHIN( <geography_expression_1> , <geography_expression_2> , <distance_in_meters> )

인자 (Arguments)

geography_expression_1

인자는 GEOGRAPHY 타입의 표현식이어야 합니다.

geography_expression_2

인자는 GEOGRAPHY 타입의 표현식이어야 합니다.

distance_in_meters

인자는 REAL 타입의 표현식이어야 합니다. 거리는 미터 단위입니다.

반환값 (Returns)

BOOLEAN을 반환합니다.

사용 참고 (Usage notes)

  • 입력 중 하나라도 NULL이면 NULL을 반환합니다.

예제 (Examples)

적도를 따라 1도 떨어진 두 점 사이의 거리(미터)가 150,000미터 미만이므로 TRUE를 반환합니다:

SELECT ST_DWITHIN (ST_MAKEPOINT(0, 0), ST_MAKEPOINT(1, 0), 150000);
+-------------------------------------------------------------+
| ST_DWITHIN (ST_MAKEPOINT(0, 0), ST_MAKEPOINT(1, 0), 150000) |
|-------------------------------------------------------------|
| True                                                        |
+-------------------------------------------------------------+

더 알아보기 (Learn more)