Geospatial Queries地理空间查询¶

GeoJSON Objects¶

To calculate geometry over an Earth-like sphere, store your location data as GeoJSON objects.要计算类地球球体上的几何体，请将位置数据存储为GeoJSON对象。

To specify GeoJSON data, use an embedded document with:要指定GeoJSON数据，请使用带有以下内容的嵌入式文档：

• a field named type that specifies the GeoJSON object type and名为type的字段，指定GeoJSON对象类型，以及
• a field named coordinates that specifies the object’s coordinates.名为coordinates的字段，用于指定对象的坐标。

  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）。

<field>: { type: <GeoJSON type> , coordinates: <coordinates> }

For example, to specify a GeoJSON Point:例如，要指定GeoJSON点：

location: {
      type: "Point",
      coordinates: [-73.856077, 40.848447]
}

For a list of the GeoJSON objects supported in MongoDB as well as examples, see GeoJSON objects.有关MongoDB中支持的GeoJSON对象的列表以及示例，请参阅GeoJSON对象。

MongoDB geospatial queries on GeoJSON objects calculate on a sphere; MongoDB uses the WGS84 reference system for geospatial queries on GeoJSON objects.MongoDB对GeoJSON对象的地理空间查询在球体上计算；MongoDB使用WGS84参考系统对GeoJSON对象进行地理空间查询。

Legacy Coordinate Pairs传统坐标对¶

To calculate distances on a Euclidean plane, store your location data as legacy coordinate pairs and use a 2d index. 要计算欧几里德平面上的距离，请将位置数据存储为传统坐标对，并使用2d索引。MongoDB supports spherical surface calculations on legacy coordinate pairs via a 2dsphere index by converting the data to the GeoJSON Point type.MongoDB通过将数据转换为GeoJSON点类型，通过2dsphere索引支持传统坐标对的球面计算。

To specify data as legacy coordinate pairs, you can use either an array (preferred) or an embedded document.要将数据指定为传统坐标对，可以使用数组（首选）或嵌入式文档。

Specify via an array (Preferred):通过数组指定（首选）：

<field>: [ <x>, <y> ]

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

<field>: [<longitude>, <latitude> ]

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

Specify via an embedded document:通过嵌入文档指定：

<field>: { <field1>: <x>, <field2>: <y> }

If specifying latitude and longitude coordinates, the first field, regardless of the field name, must contains the longitude value and the second field, the latitude value ; i.e.如果指定纬度和经度坐标，无论字段名称如何，第一个字段必须包含经度值，第二个字段必须包含纬度值；即

<field>: { <field1>: <longitude>, <field2>: <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）。

To specify legacy coordinate pairs, arrays are preferred over an embedded document as some languages do not guarantee associative map ordering.要指定传统坐标对，数组优先于嵌入式文档，因为某些语言不能保证关联地图顺序。

2dsphere¶

2dsphere indexes support queries that calculate geometries on an earth-like sphere.2dsphere索引支持在类地球球体上计算几何图形的查询。

To create a 2dsphere index, use the db.collection.createIndex() method and specify the string literal "2dsphere" as the index type:要创建2dsphere索引，请使用db.collection.createIndex()方法，并将字符串文本"2dsphere"指定为索引类型：

db.collection.createIndex( { <location field> : "2dsphere" } )

where the <location field> is a field whose value is either a GeoJSON object or a legacy coordinates pair.其中，<location field>是一个值为GeoJSON对象或遗留坐标对的字段。

For more information on the 2dsphere index, see 2dsphere Indexes.有关2dsphere索引的更多信息，请参阅2dsphere索引。

2d¶

2d indexes support queries that calculate geometries on a two-dimensional plane. 2d索引支持在二维平面上计算几何图形的查询。Although the index can support $nearSphere queries that calculate on a sphere, if possible, use the 2dsphere index for spherical queries.虽然该索引可以支持在球体上计算的$nearSphere查询，但如果可能，请使用2dsphere索引进行球体查询。

To create a 2d index, use the db.collection.createIndex() method, specifying the location field as the key and the string literal "2d" as the index type:要创建2d索引，请使用db.collection.createIndex()方法，将位置字段指定为键，将字符串文字"2d"指定为索引类型：

db.collection.createIndex( { <location field> : "2d" } )

where the <location field> is a field whose value is a legacy coordinates pair.其中，<location field>是一个值为传统坐标对的字段。

For more information on the 2d index, see 2d Indexes.有关二维索引的详细信息，请参阅2d索引。

Geospatial Indexes and Sharded Collections地理空间索引和分片集合¶

You cannot use a geospatial index as a shard key when sharding a collection. 切分集合时，不能将地理空间索引用作切分键。However, you can create a geospatial index on a sharded collection by using a different field as the shard key.但是，可以使用其他字段作为分片键，在分片集合上创建地理空间索引。

The following geospatial operations are supported on sharded collections:分片集合支持以下地理空间操作：

• $geoNear aggregation stage聚集阶段
• $near and $nearSphere query operators (starting in MongoDB 4.0)$near和$nearSphere查询运算符（从MongoDB 4.0开始）

Starting in MongoDB 4.0, $near and $nearSphere queries are supported for sharded collections.从MongoDB 4.0开始，分片集合支持$near和$nearSphere查询。

In earlier MongoDB versions, $near and $nearSphere queries are not supported for sharded collections; instead, for sharded clusters, you must use the $geoNear aggregation stage or the geoNear command (available in MongoDB 4.0 and earlier).在早期的MongoDB版本中，分片集合不支持$near和$nearSphere查询；相反，对于分片集群，必须使用$geoNear聚合阶段或geoNear命令（在MongoDB 4.0及更早版本中提供）。

You can also query for geospatial data for a sharded cluster using $geoWithin and $geoIntersect.还可以使用$geoWithin和$geoIntersect查询分片集群的地理空间数据。

Covered Queries覆盖查询¶

Geospatial indexes cannot cover a query.地理空间索引不能覆盖查询。

Geospatial Query Operators地理空间查询运算符¶

MongoDB provides the following geospatial query operators:MongoDB提供以下地理空间查询运算符：

For more details, including examples, see the individual reference page.有关更多详细信息（包括示例），请参阅个人参考页。

Geospatial Aggregation Stage地理空间聚合阶段¶

MongoDB provides the following geospatial aggregation pipeline stage:MongoDB提供以下地理空间聚合管道阶段：

For more details, including examples, see $geoNear reference page.有关更多详细信息（包括示例），请参阅$geoNear参考页。