카테고리:

지리 공간 함수

ST_DWITHIN

두 지점(두 GEOGRAPHY 오브젝트) 사이의 최소 측지 거리가 지정된 거리 내에 있으면 TRUE를 반환합니다. 그렇지 않으면 FALSE를 반환합니다.

매개 변수가 지점이 아닌 GEOGRAPHY 값(예: 선 또는 다각형)인 경우, 두 값 중 가장 가까운 두 점 사이의 최소 측지 거리를 기준으로 TRUE 또는 FALSE를 반환합니다.

검색 최적화 서비스를 사용하여 이 함수를 호출하는 쿼리의 성능을 향상할 수 있습니다. 자세한 내용은 검색 최적화 서비스 섹션을 참조하십시오.

구문

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

인자

geography_expression_1

인자는 GEOGRAPHY 형식의 식이어야 합니다.

geography_expression_2

인자는 GEOGRAPHY 형식의 식이어야 합니다.

distance_in_meters

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

반환

BOOLEAN 을 반환합니다.

사용법 노트

  • 어떤 입력이 NULL인 경우, NULL을 반환합니다.

적도를 따라 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                                                        |
+-------------------------------------------------------------+
Copy