$ geoWithin

定义¶

$geoWithin¶

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

指定的形状可以是GeoJSON 多边形 （单环或多环），GeoJSON MultiPolygon或由旧式坐标对定义的形状。该$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使用逆时针缠绕顺序，并允许$geoWithin使用面积大于或等于一个半球的单环GeoJSON 多边形支持查询。如果指定的多边形小于单个半球，$geoWithin则MongoDB CRS 的行为与默认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" }
             }
          }
       }
     }
   }
)