/ /

/ /

`geoWithin` Operator

定义

geoWithin

geoWithin 操作符支持查询给定几何图形内的地理点。即使 indexShapes 值在索引定义中为 true，也仅返回点。

您可以在以下位置查询点：

圆形
边界框
多边形

指定要搜索的坐标时，必须先指定经度，然后指定纬度。经度值可以介于-180和180之间，两者均包括在内。纬度值可以介于-90和90之间，两者均包括在内。坐标值可以是整数或双精度值。

注意

MongoDB Search 不支持以下内容：

非默认坐标参考系 (CRS)
平面 XY 坐标系（二维）
坐标对点表示法（即pointFieldName: [12, 34] ）

语法

geoWithin 通过以下语法实现：

{
  "$search": {
     "index": <index name>, // optional, defaults to "default"
     "geoWithin": {
        "path": "<field-to-search>",
        "box | circle | geometry": <object>,
        "score": <score-options>
     }
  }
}

选项

geoWithin 使用以下词条来构造查询：

字段	类型	说明	必要性
`box`	对象	指定搜索框左下角和右上角 GeoJSON 点的对象。该对象接受以下字段： `bottomLeft` - GeoJSON 左下角点。 `topRight` - 右上角的 GeoJSON点。要了解如何在 GeoJSON 对象中指定 GeoJSON 数据，请参阅GeoJSON 对象。 `box` 、 `circle`或`geometry`是必需的。	视条件而定
`circle`	对象	对象，用于指定Atlas Search的中心点和半径（以米为单位）。该对象包含以下GeoJSON字段： `center` - 指定为 GeoJSON 点的圆心。 `radius` - Radius（半径）是一个数字，以米为单位。值必须大于或等于`0` 。要了解如何在 GeoJSON 对象中指定 GeoJSON 数据，请参阅GeoJSON 对象。 `circle` 、 `box`或`geometry`是必需的。	视条件而定
`geometry`	GeoJSON 对象	GeoJSON对象，用于指定要在其中进行的 MultiPolygon 或 Polygon Atlas Search。必须将多边形指定为闭环，其中最后一个位置与第一个位置相同。计算地理空间结果时， MongoDB Search geoShape 和 geoWithin 操作符以及MongoDB $geoIntersects 操作符使用不同的几何图形。这种差异可以从MongoDB Search 和MongoDB绘制多边形边的方式看出。 MongoDB Search 根据笛卡尔距离绘制多边形，该距离是坐标参考系中两点之间的最短直线。 MongoDB使用基于2dsphere 索引的测地线模式绘制多边形，该索引构建在测地线类型第三方库之上，或者使用来自2d 索引的平面模式绘制多边形。要学习；了解详情，请参阅GeoJSON对象。对于涉及多边形的地理空间查询， MongoDB Search 和MongoDB可能会返回不同的结果。要了解如何在 GeoJSON 对象中指定 GeoJSON 数据，请参阅GeoJSON 对象。 `geometry` 、 `box`或`circle`是必需的。	视条件而定
`path`	字符串或字符串数组	已索引的 geo 类型字段或要搜索的字段。	是
`score`	对象	分配给匹配搜索结果的分数。默认情况下，结果中的分数为`1` 。您可以使用以下选项修改分数： `boost`将生成的分数乘以给定数字。 `constant`将结果分数替换为给定数字。 `function`：使用给定的表达式替换结果分数。有关在查询中使用 `score` 的信息，请参阅对结果中的文档进行评分。	no

示例

以下示例使用 sample_airbnb数据库中的 listingsAndReviews集合。如果集群上有示例数据集，则可以为地理类型创建自定义MongoDB搜索索引，并在集群上运行示例查询。

address.locationlistingsAndReviews使用以下示例索引定义为collection中的字段编制索引：

1 {
2   "mappings": {
3     "fields": {
4       "address": {
5         "fields": {
6           "location": {
7             "type": "geo"
8           }
9         },
10         "type": "document"
11       },
12       "property_type": {
13         "type": "token"
14       }
15     }
16   }
17 }

接口

`box` 例子

以下查询使用geoWithin操作符和box字段在澳大利亚的边界框中搜索属性。

查询包括：

$limit 阶段将输出限制为 3 个结果。
$project 阶段排除 name 和 address 以外的所有字段。

注意

您无需在MongoDB Search查询中指定名为 default 的索引。如果索引有任何其他名称，则必须指定 index字段。

基本示例

元数据示例

`circle` 例子

以下查询使用geoWithin操作符和circle字段搜索加拿大指定坐标一英里半径范围内的房产。

查询包括：

$limit 阶段将输出限制为 3 个结果。
使用 $project 阶段排除 name 和 address 以外的所有字段；对于 Compass 示例，请参阅所需步骤。

注意

您无需在MongoDB Search查询中指定名为 default 的索引。如果索引有任何其他名称，则必须指定 index字段。

`geometry` 示例

以下示例使用 geoWithin 操作符和 geometry 字段搜索夏威夷州的房产。type 字段指定区域是 GeoJSON 多边形还是多边形集合。

注意

您无需在MongoDB Search查询中指定名为 default 的索引。如果索引有任何其他名称，则必须指定 index字段。

后退

geoShape

来年

hasAncestor

1	{
2	"mappings": {
3	"fields": {
4	"address": {
5	"fields": {
6	"location": {
7	"type": "geo"
8	}
9	},
10	"type": "document"
11	},
12	"property_type": {
13	"type": "token"
14	}
15	}
16	}
17	}

定义

注意

语法

选项

示例

box 例子

注意

基本示例

元数据示例

circle 例子

注意

geometry 示例

注意

`box` 例子

`circle` 例子

`geometry` 示例