$geoWithin（查询谓词操作符）

定义

$geoWithin

选择地理空间数据完全位于指定形状内的文档。

指定的形状可以是GeoJSONPolygon （单环或多环）、 GeoJSONMultiPolygon 或由传统坐标对对定义的形状。$geoWithin 操作符使用$geometry 操作符来指定GeoJSON对象。

要使用默认坐标参考系 (CRS) 指定 GeoJSON 多边形或多多边形，请使用以下语法：

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

$geoWithin对于指定面积大于单个半球的GeoJSON几何图形的 查询，使用默认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 使用逆时针缠绕顺序，并允许 支持面积大于或等于单个半球的单环GeoJSON多边形的查询。如果指定的多边形小于单个半球，则MongoDB CRS$geoWithin 的$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" }
             }
          }
       }
     }
   }
)