지리적(Geographic) 및 xy 쿼리

지리적(geographic) 쿼리와 xy 쿼리를 사용하면 지도나 좌표 평면 위의 점(point)과 도형(shape)을 담고 있는 필드를 검색할 수 있어요. 지리적 쿼리는 공간(geospatial) 데이터를 다루고, xy 쿼리는 2차원 좌표 데이터를 다룹니다. 지리적 쿼리 중에서 geoshape 쿼리는 xy 쿼리와 아주 비슷한데, 전자는 지리 필드를, 후자는 데카르트(Cartesian) 필드를 검색한다는 점이 달라요.

출처: 문서

본문

xy 쿼리

xy 쿼리는 데카르트 좌표계에 있는 도형을 포함하는 문서를 검색해요. 이러한 도형은 점(point)을 지원하는 xy_point 필드와 점, 선, 원, 다각형을 지원하는 xy_shape 필드에 지정할 수 있습니다.

xy 쿼리는 다음을 포함하는 문서를 반환해요.

제공된 도형과 네 가지 공간 관계(INTERSECTS, DISJOINT, WITHIN, CONTAINS) 중 하나를 가지는 xy 도형과 xy 점
제공된 도형과 교차하는(intersect) xy 점

지리적 쿼리

지리적 쿼리는 지리 공간 도형을 포함하는 문서를 검색해요. 이러한 도형은 지도 위의 점을 지원하는 geo_point 필드와 점, 선, 원, 다각형을 지원하는 geo_shape 필드에 지정할 수 있습니다.

OpenSearch는 다음과 같은 지리적 쿼리 유형을 제공해요.

Geo-bounding box: 지오포인트(geopoint) 필드 값이 바운딩 박스(bounding box) 안에 있는 문서를 반환해요.
Geodistance: 제공된 지오포인트로부터 지정된 거리 안에 있는 지오포인트를 포함하는 문서를 반환해요.
Geopolygon: 다각형 안에 있는 지오포인트를 포함하는 문서를 반환해요.
Geoshape: 제공된 도형과 네 가지 공간 관계(INTERSECTS, DISJOINT, WITHIN, CONTAINS) 중 하나를 가지는 geoshape과 geopoint, 또는 제공된 도형과 교차하는 geopoint를 포함하는 문서를 반환해요.

더 알아보기 (Learn more)

OpenSearch 공식 문서

지리적(Geographic) 및 xy 쿼리