$geoIntersects

Definition定义

$geoIntersects

Selects documents whose geospatial data intersects with a specified GeoJSON object; i.e. where the intersection of the data and the specified object is non-empty.选择地理空间数据与指定GeoJSON对象相交的文档；即，数据和指定对象的交集不是空的。

The $geoIntersects operator uses the $geometry operator to specify the GeoJSON object. $geoIntersects运算符使用$geometry运算符指定GeoJSON对象。To specify a GeoJSON polygons or multipolygons using the default coordinate reference system (CRS), use the following syntax:要使用默认坐标参考系（CRS）指定GeoJSON多边形或多多边形，请使用以下语法：

{
  <location field>: {
     $geoIntersects: {
        $geometry: {
           type: "<GeoJSON object type>" ,
           coordinates: [ <coordinates> ]
        }
     }
  }
}

For $geoIntersects queries that specify GeoJSON geometries with areas greater than a single hemisphere, the use of the default CRS results in queries for the complementary geometries.对于指定面积大于单个半球的GeoJSON几何体的$geoIntersects查询，使用默认CRS会导致对互补几何体的查询。

A complementary geometry is the smaller of two geometries. If a specified geometry covers more than a hemisphere, the default CRS query returns documents for the complementary geometry.互补几何体是两个几何体中较小的一个。如果指定的几何体覆盖了多个半球，则默认的CRS查询将返回互补几何体的文档。

For example, if you define a geometry to be an area covering 75% of Earth's surface, CRS uses the remaining 25% as the complementary area. The query returns results from that smaller complementary 25% area instead of the larger 75%.例如，如果将几何体定义为覆盖地球表面75%的区域，CRS将剩余的25%用作补充区域。查询返回的结果来自较小的互补25%区域，而不是较大的75%区域。

The Examples section on this page shows how to specify smaller and larger areas.本页的示例部分显示了如何指定更小和更大的区域。

To specify a single-ringed GeoJSON polygon with a custom MongoDB CRS, use the following prototype that specifies the custom MongoDB CRS in the $geometry expression:要使用自定义MongoDB CRS指定一个单环GeoJSON多边形，请使用以下原型在$geometry表达式中指定自定义MongoDB CRS：

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

The custom MongoDB CRS uses a counter-clockwise winding order and allows $geoIntersects to support queries with a single-ringed GeoJSON polygon whose area is greater than or equal to a single hemisphere. 自定义MongoDB CRS使用逆时针缠绕顺序，并允许$geoIntersects支持使用面积大于或等于单个半球的单个环形GeoJSON多边形的查询。If the specified polygon is smaller than a single hemisphere, the behavior of $geoIntersects with the MongoDB CRS is the same as with the default CRS. See also "Big" Polygons.如果指定的多边形小于单个半球，则$geoIntersects与MongoDB CRS的行为与默认CRS的行为相同。另请参见“大”多边形。

Important

If specifying latitude and longitude coordinates, list the longitude first, and then latitude.如果指定纬度和经度坐标，请先列出经度，然后再列出纬度。

• Valid longitude values are between -180 and 180, both inclusive.有效的经度值介于-180和180之间，包括-180和180。
• Valid latitude values are between -90 and 90, both inclusive.有效的纬度值介于-90和90之间，包括-90和90。

Behavior行为

Examples示例

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

db.places.find(
   {
     loc: {
       $geoIntersects: {
          $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" }
             }
          }
       }
     }
   }
)