Couchbase Search 서비스는 Couchbase Server 릴리스 7.1.2를 통해 고차원 위치 기반 정보 인덱싱 및 쿼리 기능을 도입합니다.
이 새로운 기능이 추가되기 전까지는 검색 서비스가 단일 차원 지오포인트/위치 필드를 색인하는 것으로 제한되어 있었습니다. 쿼리는 색인된 지오포인트 필드에 대한 점-거리, 경계-직사각형, 경계-다각형과 같은 경계 쿼리로 제한되었습니다. 하지만 지오포인트만으로는 실제 도형이나 구조물의 다양한 공간적 세부 사항을 표현하는 데 효과적이지 않다는 것을 알고 있습니다.
이러한 고차원 공간 구조를 지원함으로써 사용자는 우편 또는 관할 지역 경계, 배달 차량이나 항공사의 경로, 강, 호수, 하천 등 다양한 수역의 경계와 같은 다양한 실생활의 형태를 근사화할 수 있습니다.
검색 서비스는 이제 GeoJSON 공간 데이터 형식 구형 측지학 이 릴리스에 추가되었습니다. 이를 통해 사용자는 GeoJSON 모양이 있는 모든 문서를 찾는 것과 같은 사용 사례를 해결할 수 있습니다:
-
- 쿼리 모양을 포함합니다.
- 는 쿼리 모양 내에 있어야 합니다.
- 쿼리 모양과 교차
지원되는 GeoJSON 모양은 다음과 같습니다:
위의 도형 외에도 검색은 사용자가 공간 근사치를 쉽게 만들 수 있도록 몇 가지 사용자 정의 도형을 추가로 지원합니다. 지원되는 추가 도형은 다음과 같습니다:
-
- 서클
- 봉투
새로운 GeoJSON 유형
다양한 모양 유형을 한 눈에 살펴 보겠습니다.
GeoJSON의 모든 단순 도형은 다음과 같이 구성됩니다. 유형 좌표 모음입니다.
포인트
다음은 GeoJSON을 지정합니다. 포인트 필드에 입력합니다:
|
1 2 3 4 |
{ "type": "포인트", "좌표": [75.05687713623047,22.53539059204079] } |
포인트는 건물의 위치 또는 지리적 위치 API에서 제공하는 현재 위치와 같은 단일 지리적 좌표입니다.
참고 : 표준은 경도와 위도의 배열 형식과 같은 좌표를 지정하는 단일 방법만 지원합니다: [롱, 위도].
라인 문자열
다음은 GeoJSON을 지정합니다. 라인 문자열 필드에 입력합니다:
|
1 2 3 4 5 6 7 |
{ "type": "LineString", "좌표": [ [ 77.01416015625, 23.0797317624497], [ 78.134765625, 20.385825381874263] ] } |
선형 문자열은 두 개 이상의 위치 배열로 정의됩니다. 두 점만 지정하면 선형 문자열은 직선을 나타냅니다. 두 개 이상의 점을 지정하면 임의의 경로가 생성됩니다.
다각형
다음은 GeoJSON을 지정합니다. 다각형 필드에 입력합니다:
|
1 2 3 4 5 6 7 8 9 |
{ "type": "다각형", "좌표": [ [ [ 85.605, 57.207], [ 86.396, 55.998], [ 87.033, 56.716], [ 85.605, 57.207] ] ] } |
다각형은 점의 목록으로 정의됩니다. 각 (외부) 목록의 첫 번째 점과 마지막 점은 동일해야 합니다(즉, 다각형이 닫혀 있어야 합니다). 그리고 외부 좌표는 다음 위치에 있어야 합니다. 시계 반대 방향 오데다각형의 r(CCW).
구멍이 있는 다각형도 지원됩니다. 구멍은 다음을 따라야 합니다. 시계 방향 주문 를 경계 정점으로 설정합니다.
링이 하나인 다각형의 경우 링은 자체 교차할 수 없습니다.
참고: 카우치베이스 서버 릴리스 7.1.2의 도형에는 정점의 CCW 순서가 엄격하게 요구되며, 이 요구 사항을 위반하면 예기치 않은 검색 결과가 발생합니다.
멀티포인트
다음은 GeoJSON을 지정합니다. 멀티포인트 필드에 입력합니다:
|
1 2 3 4 5 6 7 8 9 |
{ "type": "멀티포인트", "좌표": [ [ -115.8343505859375, 38.45789034424927], [ -115.81237792968749, 38.19502155795575], [ -120.80017089843749, 36.54053616262899], [ -120.67932128906249, 36.33725319397006] ] } |
멀티라인 문자열
다음은 GeoJSON을 지정합니다. 멀티라인 문자열 필드에 입력합니다:
|
1 2 3 4 5 6 7 8 |
{ "type": "멀티라인 문자열", "좌표": [ [ [ -118.31726074, 35.250105158],[ -117.509765624, 35.3756141] ], [ [ -118.6962890, 34.624167789],[ -118.317260742, 35.03899204] ], [ [ -117.9492187, 35.146862906], [ -117.6745605, 34.41144164] ] ] } |
멀티폴리곤
다음은 GeoJSON을 지정합니다. 멀티폴리곤 필드에 입력합니다:
|
1 2 3 4 5 6 7 8 9 10 |
{ "type": "멀티폴리곤", "좌표": [ [ [ [ -73.958, 40.8003 ], [ -73.9498, 40.7968 ], [ -73.9737, 40.7648 ], [ -73.9814, 40.7681 ], [ -73.958, 40.8003 ] ] ], [ [ [ -73.958, 40.8003 ], [ -73.9498, 40.7968 ], [ -73.9737, 40.7648 ], [ -73.958, 40.8003 ] ] ] ] } |
지오메트리 컬렉션
다음은 GeoJSON을 지정합니다. 지오메트리 컬렉션 필드에 입력합니다:
지오메트리 컬렉션에는 "geometries"라는 이름을 가진 멤버가 있습니다. "geometries"의 값은 배열입니다. 이 배열의 각 요소는 GeoJSON 지오메트리 객체입니다. 이 배열은 비어 있을 수 있습니다.
위에서 설명한 다른 지오메트리 유형과 달리 지오메트리 컬렉션은 작은 지오메트리 개체의 이질적인 구성이 될 수 있습니다. 예를 들어 소문자 로마자 "i" 모양의 Geometry 개체는 하나의 점과 하나의 LineString으로 구성될 수 있습니다.
중첩된 지오메트리 컬렉션이 유효하지 않습니다.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 |
{ "type": "지오메트리 컬렉션", "geometries": [ { "type": "멀티포인트", "좌표": [ [ -73.9580, 40.8003 ], [ -73.9498, 40.7968 ], [ -73.9737, 40.7648 ], [ -73.9814, 40.7681 ] ] }, { "type": "멀티라인 문자열", "좌표": [ [ [ -73.96943, 40.78519 ], [ -73.96082, 40.78095 ] ], [ [ -73.96415, 40.79229 ], [ -73.95544, 40.78854 ] ], [ [ -73.97162, 40.78205 ], [ -73.96374, 40.77715 ] ], [ [ -73.97880, 40.77247 ], [ -73.97036, 40.76811 ] ] ] }, { "type" : "다각형", "좌표" : [ [ [ 0 , 0 ] , [ 3 , 6 ] , [ 6 , 1 ] , [ 0 , 0 ] ], [ [ 2 , 2 ] , [ 3 , 3 ] , [ 4 , 2 ] , [ 2 , 2 ] ] ] } ] } |
서클
사용자가 지구 표면 위에 원형 영역을 덮고자 하는 경우 이 모양을 사용할 수 있습니다.
원형 모양 샘플은 아래와 같습니다.
|
1 2 3 4 5 |
{ "type": "원", "좌표": [75.05687713623047,22.53539059204079], "radius": "1000m" } |
원은 반지름과 함께 중심점 좌표 위에 지정됩니다.
반경에 지원되는 형식의 예는 다음과 같습니다:
"5인치" , "5인치" , "7야드" , "7야드", "9피트" , "9피트", "11km" , "11킬로미터", "3nm" , "3해리", "13mm" , "13밀리미터", "15cm" , "15센티미터", "17미리" , "17마일" 19m 또는 "19미터"를 입력합니다.
단위를 확인할 수 없는 경우 전체 문자열을 구문 분석하고 단위는 미터 가 가정됩니다.
봉투
엔벨로프 유형: 도형의 왼쪽 위와 오른쪽 아래 점의 좌표로 구성되어 경계 직사각형을 다음과 같은 형식으로 나타냅니다. [[최소론, 최대론], [최대론, 최소론]].
|
1 2 3 4 5 6 7 |
{ "type": "봉투", "좌표": [ [72.83, 18.979], [78.508,17.4555] ] } |
공간 필드 인덱싱 - 새 기능 지오셰이프 필드 유형
검색에 다음과 같은 필드 유형이 도입되었습니다. 지오셰이프 를 사용하여 앞서 언급한 공간 모양을 표현할 수 있습니다.
문서에 geoJSON 형식을 준수하는 지리적 도형 정보가 포함된 'geometry'라는 이름의 필드가 있는 경우, 먼저 아래와 같이 인덱스 정의의 유형 매핑 아래에 지리적 공간 필드를 포함할 수 있습니다.
마지막으로 색인 만들기 버튼을 누르면 지리공간 데이터를 쿼리할 수 있습니다.
참고 지오셰이프 필드 유형은 다음을 포함하여 앞서 언급한 모든 공간 유형을 인덱싱할 수 있습니다. 포인트, 라인스트링, 다각형, 멀티포인트, 멀티라인스트링, 멀티폴리곤, 지오메트리컬렉션, 원, 봉투.
공간 필드 쿼리 - 새로운 지오셰이프 쿼리
검색은 주로 색인된 이질적인 유형의 지오셰이프에 대해 세 가지 유형의 공간 쿼리 기능을 지원합니다.
쿼리 구조:
|
1 2 3 4 5 6 7 8 9 10 11 12 |
{ "query": { "field": " <> ", "지오메트리": { "모양": { "type": " <> ", "좌표": [[[ ]]] }, "관계": " <> " } } } |
세부 정보:
-
- shapeDesc - 포인트, 라인스트링, 폴리곤, 멀티포인트, 멀티라인스트링, 멀티폴리곤, 지오메트리컬렉션, 원, 봉투 등 9가지 유형 중 하나가 될 수 있습니다.
- 관계 - 교차, 포함, 내 등 3가지 유형 중 하나 일 수 있습니다.
| 관계 | 결과 |
| 교차 | 다음과 같은 모든 문서를 반환합니다. 공간 필드가 쿼리 지오메트리와 교차합니다. |
| 포함 | 다음과 같은 모든 문서를 반환합니다. 공간 필드에는 쿼리 지오메트리가 포함됩니다. |
| WITHIN | 다음과 같은 모든 문서를 반환합니다. 공간 필드가 쿼리 지오메트리 내에 있습니다. |
몇 가지 쿼리 샘플을 살펴보겠습니다.
포인트 포함 쿼리 는 쿼리에서 지정된 지점을 포함하는 도형을 가진 일치하는 모든 문서를 반환합니다:
|
1 2 3 4 5 6 7 8 9 10 11 12 |
{ "query": { "field": "<>", "지오메트리": { "모양": { "type": "point", "좌표": [75.05687713623047, 22.53539059204079] }, "관계": "포함" } } } |
라인 문자열 교차 쿼리 는 쿼리의 선형 문자열과 교차하는 도형과 일치하는 모든 문서를 반환합니다:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
{ "query": { "field": "<>", "지오메트리": { "모양": { "type": "linestring", "좌표": [ [77.01416015625, 23.079731762449878], [78.134765625, 20.385825381874263] ] }, "관계": "교차" } } } |
다각형 withIn 쿼리 는 쿼리에서 다각형 영역 내에 완전히 존재하는 도형과 일치하는 모든 문서를 반환합니다:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 |
{ "query": { "field": "<>", "지오메트리": { "모양": { "type": "다각형", "좌표": [ [ [77.59012699127197, 12.959853852513307], [77.59836673736572, 12.959853852513307], [77.59836673736572, 12.965541604118611], [77.59012699127197, 12.965541604118611], [77.59012699127197, 12.959853852513307] ] ] }, "관계": "내" } } } |
추가 팁
검색 서비스는 측지학 또는 구형 기하학을 사용하여 고급 공간 기능을 지원합니다. 즉, 공간 필터를 수행하는 동안 지구 표면의 곡률이 고려됩니다. 주어진 도형의 경계 정렬의 차이를 관찰할 때 이 점을 염두에 두시기 바랍니다.
이러한 리소스는 테스트 데이터의 지오메트리를 이해하고 검증하는 데 도움이 될 수 있습니다:
-
- 구형 매퍼에 대한 참조 - gcmap
- 지오숀 셰이프 확인을 위한 참고 자료 - 참조 geojson.io
- 버텍스 순서 또는 GeoJSON의 정확성 검증을 위한 참조 - 참고 자료 geojsonlint
