$geoWithin

정의

$geoWithin

지정된 모양 안에만 존재하는 지리 공간적 데이터가 있는 문서를 선택합니다.

지정된 모양은 GeoJSON Polygon(단일 고리 또는 다중 고리), GeoJSON MultiPolygon 또는 기존 좌표 쌍으로 정의된 모양일 수 있습니다. $geoWithin 연산자는 $geometry 연산자를 사용하여 GeoJSON 객체를 지정합니다.

기본 좌표계(CRS)를 사용하여 GeoJSON 다각형 또는 다중 다각형을 지정하려면 다음 구문을 사용합니다.

{
   <location field>: {
      $geoWithin: {
         $geometry: {
            type: <"Polygon" or "MultiPolygon"> ,
            coordinates: [ <coordinates> ]
         }
      }
   }
}

단일 반구보다 면적이 큰 GeoJSON 도형을 지정하는 $geoWithin 쿼리의 경우, 기본 CRS를 사용하면 보완적인 도형에 대한 쿼리가 생성됩니다.

사용자 지정 MongoDB CRS를 사용하여 단일 고리 GeoJSON 다각형을 지정하려면 $geometry 표현식에 사용자 지정 MongoDB CRS를 지정하는 다음 프로토타입을 사용하세요.

{
   <location field>: {
      $geoWithin: {
         $geometry: {
           type: "Polygon" ,
           coordinates: [ <coordinates> ],
           crs: {
              type: "name",
              properties: { name: "urn:x-mongodb:crs:strictwinding:EPSG:4326" }
           }
         }
      }
   }
}

사용자 지정 MongoDB CRS는 시계 반대 방향의 와인딩 순서를 사용하며, $geoWithin가 단일 반구보다 크거나 같은 면적을 갖는 단일 고리 GeoJSON 다각형이 있는 쿼리를 지원할 수 있도록 합니다. 지정된 다각형이 단일 반구보다 작은 경우 MongoDB CRS를 사용한 $geoWithin의 동작은 기본 CRS를 사용한 경우와 동일합니다. '큰' 다각형도 참조하세요.

평면의 레거시 좌표 쌍으로 정의된 모양에 포함되도록 쿼리하는 경우 다음 구문을 사용합니다.

{
   <location field>: {
      $geoWithin: { <shape operator>: <coordinates> }
   }
}

사용 가능한 모양 연산자는 다음과 같습니다.

• $box,

• $polygon,

• $center (원을 정의합니다), 그리고

• $centerSphere (구의 원을 정의합니다).

중요

경도와 위도를 사용하는 경우 longitude, latitude 순으로 좌표를 지정합니다.

행동

예시

db.places.find(
   {
     loc: {
       $geoWithin: {
          $geometry: {
             type : "Polygon" ,
             coordinates: [ [ [ 0, 0 ], [ 3, 6 ], [ 6, 1 ], [ 0, 0 ] ] ]
          }
       }
     }
   }
)

db.places.find(
   {
     loc: {
       $geoWithin: {
          $geometry: {
             type : "Polygon" ,
             coordinates: [
               [
                 [ -100, 60 ], [ -100, 0 ], [ -100, -60 ], [ 100, -60 ], [ 100, 60 ], [ -100, 60 ]
               ]
             ],
             crs: {
                type: "name",
                properties: { name: "urn:x-mongodb:crs:strictwinding:EPSG:4326" }
             }
          }
       }
     }
   }
)