Query geoespacial

Objetos GeoJSON

Para calcular geometría sobre una esfera similar a la Tierra, almacene sus datos de ubicación como objetos GeoJSON.

Para especificar datos de GeoJSON, utilice un documento incrustado con:

• un campo llamado type que especifica el tipo de objeto GeoJSON, y

• un campo llamado coordinates que especifica las coordenadas del objeto.

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

Por ejemplo, para especificar un punto GeoJSON:

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

Para una lista de los objetos GeoJSON compatibles con MongoDB, así como ejemplos, vea GeoJSON objects.

Las consultas geoespaciales de MongoDB sobre objetos GeoJSON se calculan en una esfera; MongoDB utiliza el sistema de referencia WGS84 para consultas geoespaciales sobre objetos GeoJSON.

Legacy Coordinate Pairs

Para calcular distancias en un plano euclidiano, almacena los datos de ubicación como legacy coordinate pairs y usa un índice 2d. MongoDB admite cálculos de superficies esféricas en legacy coordinate pairs utilizando un índice2dsphere si conviertes manualmente los datos al tipo de punto GeoJSON.

Para especificar datos como legacy coordinate pairs, puede usar un arreglo (preferido) o un documento incrustado.

Especifica mediante un arreglo (Preferido):

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

Si especifica coordenadas de latitud y longitud, enumere primero la longitud y luego la latitud; es decir,

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

• Los valores de longitud válidos están entre -180 y 180, ambos inclusive.

• Los valores de latitud válidos están entre -90 y 90, ambos inclusive.

Especifique mediante un documento incrustado:

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

Si especifica coordenadas de latitud y longitud, el primer campo, independientemente del nombre del campo, debe contener el valor de longitud y el segundo campo, el valor de latitud; es decir.

<field>: { <field1>: <longitude>, <field2>: <latitude> }

• Los valores de longitud válidos están entre -180 y 180, ambos inclusive.

• Los valores de latitud válidos están entre -90 y 90, ambos inclusive.

Para especificar pares de coordenadas heredadas, se prefieren los arreglos a un documento incrustado, ya que algunos lenguajes no ofrecen garantías de orden asociativo de los mapas.

2dsphere

Los índices 2dsphere admiten queries que calculan geometrías sobre una esfera similar a la Tierra.

Para crear un índice 2dsphere, utiliza el método db.collection.createIndex() y especifica el literal de cadena "2dsphere" como el tipo de índice:

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

en que el <location field> es un campo cuyo valor es un objeto GeoJSON o un par de coordenadas heredadas.

Para obtener más información sobre el 2dsphere índice, consulte 2dsphere Índices.

2d

Los índices 2d admiten consultas que calculan geometrías en un plano bidimensional. Aunque el índice puede admitir queries $nearSphere que calculan sobre una esfera, siempre que sea posible, usa el índice 2dsphere para queries esféricas.

Para crear un índice 2d, utiliza el método db.collection.createIndex(), especificando el campo de ubicación como la clave y el literal de string "2d" como el tipo de índice:

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

en el que <location field> es un campo cuyo valor es un par de coordenadas heredadas.

Para obtener más información sobre el 2d índice, consulte 2d Índices.

Índices geoespaciales y colecciones fragmentadas

No se puede usar un índice geoespacial como clave de fragmento al fragmentar una colección. Sin embargo, sí se puede crear un índice geoespacial en una colección fragmentada usando un campo diferente como clave de fragmento.

Las siguientes operaciones geoespaciales son compatibles con colecciones fragmentadas:

• $geoNear etapa de agregación

• $near y $nearSphere operadores del query

También puede consultar datos geoespaciales para un clúster fragmentado utilizando $geoWithin $geoIntersectsy.

Consultas cubiertas

Los índices geoespaciales no pueden cubrir una consulta.

Operadores del query geoespacial

MongoDB proporciona los siguientes operadores de consulta geoespacial:

Para obtener más detalles, incluidos ejemplos, consulte la página de referencia individual.

Etapa de agregación geoespacial

MongoDB proporciona la siguiente etapa de la canalización de agregación geoespacial:

Para más detalles, incluidos ejemplos, consulta la página de referencia $geoNear.