Geospatial Queries地理空间查询

GeoJSON ObjectsGeoJSON对象

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（坐标）的字段，指定对象的坐标。

<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.在球体上计算GeoJSON对象的MongoDB地理空间查询；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. MongoDB supports spherical surface calculations on legacy coordinate pairs by using a 2dsphere index if you manually convert the data to the GeoJSON Point type.要计算欧几里德平面上的距离，请将位置数据存储为传统坐标对，并使用2d索引。如果您手动将数据转换为GeoJSON Point类型，MongoDB支持使用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之间，包括-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 contain 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.索引支持计算类地球体上几何图形的查询。

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

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索引的更多信息，请参阅2d索引。

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

MongoDB provides the following geospatial query operators. For more details, including examples, see the respective reference pages.MongoDB提供以下地理空间查询运算符。有关更多详细信息，包括示例，请参阅相应的参考页面。

Geospatial Aggregation Stage地理空间聚合阶段

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

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