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指定GeoJSON对象类型的名为type的字段，以及
• a field named coordinates that specifies the object's coordinates.一个名为coordinates的字段，用于指定对象的坐标。
  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）。

<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 by using a 2dsphere index if you manually convert the data to the GeoJSON Point type.如果手动将数据转换为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 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索引的详细信息，请参阅2d索引。

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参考页。