$ geoNear（汇总）

定义¶

$geoNear¶

以距指定点最近到最远的顺序输出文档。

注意

从4.2版开始，MongoDB删除该阶段的limit和num 选项，$geoNear以及默认的100个文档限制。要限制的结果 $geoNear，请将$geoNear舞台与舞台一起 使用$limit。

该$geoNear阶段具有以下原型形式：

复制

{ $geoNear: { <geoNear options> } }

该$geoNear运营商接受一个文档，包含下面$geoNear的选项。以与已处理文档的坐标系相同的单位指定所有距离：

领域	类型	描述
near	GeoJSON点或旧版坐标对	查找最近文档的点。 如果使用2dsphere索引，则可以将点指定为GeoJSON点或旧版坐标对。 如果使用2d索引，则将点指定为旧坐标对。
distanceField	串	包含计算出的距离的输出字段。要在嵌入式文档中指定字段，请使用点符号。
spherical	布尔值	可选的。确定MongoDB如何计算两点之间的距离： true设为时，MongoDB使用$nearSphere语义并使用球形几何来计算距离。 当为时false，MongoDB使用以下$near语义：2dsphere 索引为球形几何，而2d索引为平面几何。 默认值：false。
maxDistance	数	可选的。从中心点的最大距离，这些文件可以 是。MongoDB将结果限制为距中心点指定距离内的那些文档。 如果指定的点是GeoJSON，则以米为单位指定距离；如果 指定的点是旧式坐标对，则以弧度指定距离 。
query	文献	可选的。将结果限制为与查询匹配的文档。查询语法是常用的MongoDB 读取操作查询语法。 您不能在阶段$near的query字段中指定谓词$geoNear。
distanceMultiplier	数	可选的。将查询返回的所有距离相乘的因子。例如，使用distanceMultiplier乘以地球半径，即可将球形查询返回的弧度转换为千米。
includeLocs	串	可选的。这指定了标识用于计算距离的位置的输出字段。当位置字段包含多个位置时，此选项很有用。要在嵌入式文档中指定字段，请使用点符号。
uniqueDocs	布尔值	可选的。如果此值为true，则查询返回一次匹配的文档，即使该文档的多个位置字段与查询匹配也是如此。 从2.6版开始不推荐使用：地理空间查询不再返回重复的结果。该 $uniqueDocs运营商对结果没有任何影响。
minDistance	数	可选的。距文档中心点的最小距离。MongoDB将结果限制为距中心点超出指定距离的那些文档。 为GeoJSON数据指定距离（以米为单位），为旧坐标对指定距离（以弧度为单位）。 3.2版中的新功能。
key		可选的。指定在计算距离时要使用的地理空间索引字段。 如果您的集合具有多个2d和/或多个2dsphere 索引，则必须使用该key选项来指定要使用的索引字段路径。指定要使用的地理空间索引 提供了完整的示例。 如果存在多个2d索引或多个2dsphere 索引，而您未指定key，则MongoDB将返回错误。 如果未指定key，并且最多只有一个 2d索引和/或只有一个2dsphere索引，则MongoDB首先会寻找2d要使用的索引。如果2d索引不存在，则MongoDB查找2dsphere要使用的索引。 版本4.0中的新功能。

行为¶

使用时$geoNear，请考虑：

• 您只能$geoNear用作管道的第一阶段。

• 您必须包括该distanceField选项。该 distanceField选项指定将包含计算出的距离的字段。

• $geoNear需要地理空间索引。

  如果集合上有多个地理空间索引，请使用 keys参数指定要在计算中使用的字段。如果只有一个地理空间索引，则$geoNear隐式使用索引字段进行计算。

• 您不能在阶段$near的query字段中指定谓词$geoNear。
• 视图不支持geoNear操作（即 $geoNear管道阶段）。
• 从4.2版开始，$geoNear默认文档不再限制为100个。

例子¶

考虑places具有2dsphere索引的集合。以下汇总用于$geoNear查找距中心最多2米且等于的文档。[ -73.99279 , 40.719296 ]categoryParks

db.places.aggregate([
   {
     $geoNear: {
        near: { type: "Point", coordinates: [ -73.99279 , 40.719296 ] },
        distanceField: "dist.calculated",
        maxDistance: 2,
        query: { category: "Parks" },
        includeLocs: "dist.location",
        spherical: true
     }
   }
])

聚合返回以下内容：

{
   "_id" : 8,
   "name" : "Sara D. Roosevelt Park",
   "category" : "Parks",
   "location" : {
      "type" : "Point",
      "coordinates" : [ -73.9928, 40.7193 ]
   },
   "dist" : {
      "calculated" : 0.9539931676365992,
      "location" : {
         "type" : "Point",
         "coordinates" : [ -73.9928, 40.7193 ]
      }
   }
}

匹配的文档包含两个新字段：

• dist.calculated 包含计算出的距离的字段，以及
• dist.location 包含计算中使用的位置的字段。

db.places.aggregate([
   {
     $geoNear: {
        near: { type: "Point", coordinates: [ -73.99279 , 40.719296 ] },
        distanceField: "dist.calculated",
        minDistance: 2,
        query: { category: "Parks" },
        includeLocs: "dist.location",
        spherical: true
     }
   }
])

{
   "_id" : 3,
   "name" : "Polo Grounds",
   "location": {
      "type" : "Point",
      "coordinates" : [ -73.9375, 40.8303 ]
   },
   "legacy" : [ -73.9375, 40.8303 ],
   "category" : "Stadiums"
}

db.places.aggregate([
   {
     $geoNear: {
        near: { type: "Point", coordinates: [ -73.98142 , 40.71782 ] },
        key: "location",
        distanceField: "dist.calculated",
        query: { "category": "Parks" }
     }
   },
   { $limit: 5 }
])

{
   "_id" : 8,
   "name" : "Sara D. Roosevelt Park",
   "location" : {
      "type" : "Point",
      "coordinates" : [
         -73.9928,
         40.7193
      ]
   },
   "category" : "Parks",
   "dist" : {
      "calculated" : 974.175764916902
   }
}
{
   "_id" : 1,
   "name" : "Central Park",
   "location" : {
      "type" : "Point",
      "coordinates" : [
         -73.97,
         40.77
      ]
   },
   "legacy" : [
      -73.97,
      40.77
   ],
   "category" : "Parks",
   "dist" : {
      "calculated" : 5887.92792958097
   }
}