Docs Home → MongoDB Manual

$geoIntersects

On this page本页内容

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会导致对互补几何体的查询。

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行为

Geospatial Indexes地理空间索引

$geoIntersects uses spherical geometry. $geoIntersects使用球形几何体。$geoIntersects does not require a geospatial index. 不需要地理空间索引。However, a geospatial index will improve query performance. 但是，地理空间索引将提高查询性能。Only the 2dsphere geospatial index supports $geoIntersects.只有2dsphere地理空间索引支持$geoIntersects。

Degenerate Geometry退化几何体

$geoIntersects does not guarantee that it will consider a polygon to intersect with its own edges; its own vertices; or another polygon sharing vertices or edges but no interior space.并不保证它会认为多边形与其自身的边相交；其自身的顶点；或者共享顶点或边但没有内部空间的另一个多边形。

"Big" Polygons“大”多边形

For $geoIntersects, if you specify a single-ringed polygon that has an area greater than a single hemisphere, include the custom MongoDB coordinate reference system in the $geometry expression. 对于$geoIntersects，如果指定面积大于单个半球的单个环形多边形，请在$geometry表达式中包含自定义MongoDB坐标参考系。Otherwise, $geoIntersects queries for the complementary geometry. 否则，$geoIntersects将查询互补几何体。For all other GeoJSON polygons with areas greater than a hemisphere, $geoIntersects queries for the complementary geometry.对于面积大于半球的所有其他GeoJSON多边形，$geoIntersects查询互补几何体。

Examples实例

Intersects a Polygon与多边形相交

The following example uses $geoIntersects to select all loc data that intersect with the Polygon defined by the coordinates array. 以下示例使用$geoIntersects选择与coordinates（坐标）数组定义的Polygon相交的所有loc数据。The area of the polygon is less than the area of a single hemisphere:多边形的面积小于单个半球的面积：

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

For single-ringed polygons with areas greater than a single hemisphere, see Intersects a "Big" Polygon.有关面积大于单个半球的单环形多边形，请参阅相交“大”多边形。

Intersects a "Big" Polygon与“大”多边形相交

To query with a single-ringed GeoJSON polygon whose area is greater than a single hemisphere, the $geometry expression must specify the custom MongoDB coordinate reference system. 要使用面积大于单个半球的单环GeoJSON多边形进行查询，$geometry表达式必须指定自定义MongoDB坐标参考系统。For example:例如：

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" }
             }
          }
       }
     }
   }
)