$geoNear (agregación)

Definición

$geoNear

Genera documentos en orden del más cercano al más lejano desde un punto específico.

Nota

MongoDB elimina las limit num opciones y para la etapa, así como el límite predeterminado $geoNear de 100 documentos. Para limitar los resultados de,$geoNear utilice la etapa $geoNear con $limit escenario.

La etapa $geoNear tiene la siguiente forma de prototipo:

{ $geoNear: { <geoNear options> } }

El operador $geoNear acepta un documento que contiene las siguientes opciones $geoNear. Especifique todas las distancias en las mismas unidades que las del sistema de coordenadas de los documentos procesados:

Campo	Tipo	Descripción
distanceField	string	El campo de salida que contiene la distancia calculada. Para especificar un campo dentro de un documento incrustado, utilice la notación de puntos.
distanceMultiplier	Número	Opcional. El factor para multiplicar todas las distancias devueltas por la consulta. Por ejemplo, use distanceMultiplier para convertir radianes, como los devueltos por una consulta esférica, a kilómetros multiplicándolos por el radio de la Tierra.
includeLocs	string	Opcional. Especifica el campo de salida que identifica la ubicación utilizada para calcular la distancia. Esta opción es útil cuando un campo de ubicación contiene varias ubicaciones. Para especificar un campo dentro de un documento incrustado, utilice la notación de puntos.
key		Opcional. Especifique el campo indexado geoespacial que se utilizará al calcular la distancia. Si su colección tiene 2d varios 2dsphere índices o,debe usar la key opción para especificar la ruta del campo indexado. En "Especificar quéíndice geoespacial usar" se ofrece un ejemplo completo. Si hay más de un índice 2d o más de un índice 2dsphere y no especifica un key, MongoDB devolverá un error. Si no especifica key y solo tiene un índice 2d o un índice 2dsphere como máximo, MongoDB busca primero un índice 2d. Si no existe un índice 2d, MongoDB busca un índice 2dsphere.
maxDistance	Número	Opcional. La distancia máxima desde el punto central a la que pueden estar los documentos. MongoDB limita los resultados a los documentos que se encuentran dentro de la distancia especificada desde el punto central. Especifique la distancia en metros si el punto especificado es GeoJSON y en radianes si el punto especificado son pares de coordenadas heredados.
minDistance	Número	Opcional. La distancia mínima desde el punto central a la que pueden estar los documentos. MongoDB limita los resultados a los documentos que se encuentran fuera de la distancia especificada desde el punto central. Especifique la distancia en metros para los datos GeoJSON y en radianes para los pares de coordenadas heredados. Nuevo en la versión 3.2.
near	Punto GeoJSON o par de coordenadas heredadas	El punto donde encontrar los documentos más cercanos. Si utiliza un índice 2dsphere, puede especificar el punto como un punto GeoJSON o un par de coordenadas heredadas. Si utiliza un índice d, especifique el punto como un par de coordenadas 2 heredado.
query	Documento	Opcional. Limita los resultados a los documentos que coinciden con la consulta. La sintaxis de consulta es la habitual para operaciones de lectura de MongoDB. No se puede especificar un predicado en $near el query campo de la $geoNear etapa.
spherical	booleano	Opcional. Determina cómo MongoDB calcula la distancia entre dos puntos: trueCuando, MongoDB utiliza la semántica y calcula distancias utilizando geometría $nearSphere esférica. falseCuando, MongoDB utiliza semántica:$near geometría esférica para índices 2dsphere y geometría 2plana para índices d. Por defecto: falso.

Comportamiento

Ejemplos

Cree una colección places con los siguientes documentos:

db.places.insertMany( [
   {
      name: "Central Park",
      location: { type: "Point", coordinates: [ -73.97, 40.77 ] },
      category: "Parks"
   },
   {
      name: "Sara D. Roosevelt Park",
      location: { type: "Point", coordinates: [ -73.9928, 40.7193 ] },
      category: "Parks"
   },
   {
      name: "Polo Grounds",
      location: { type: "Point", coordinates: [ -73.9375, 40.8303 ] },
      category: "Stadiums"
   }
] )

La siguiente operación crea un índice 2dsphere en el campo location:

db.places.createIndex( { location: "2dsphere" } )

db.places.aggregate([
   {
     $geoNear: {
        near: { type: "Point", coordinates: [ -73.99279 , 40.719296 ] },
        distanceField: "dist.calculated",
        maxDistance: 2,
        query: { category: "Parks" },
        includeLocs: "dist.location",
        spherical: true
     }
   }
])

{
   "_id" : 8,
   "name" : "Sara D. Roosevelt Park",
   "category" : "Parks",
   "location" : {
      "type" : "Point",
      "coordinates" : [ -73.9928, 40.7193 ]
   },
   "dist" : {
      "calculated" : 0.9539931676365992,
      "location" : {
         "type" : "Point",
         "coordinates" : [ -73.9928, 40.7193 ]
      }
   }
}

db.places.aggregate([
   {
     $geoNear: {
        near: { type: "Point", coordinates: [ -73.99279 , 40.719296 ] },
        distanceField: "dist.calculated",
        minDistance: 2,
        query: { category: "Parks" },
        includeLocs: "dist.location",
        spherical: true
     }
   }
])

{
   "_id" : 3,
   "name" : "Polo Grounds",
   "location": {
      "type" : "Point",
      "coordinates" : [ -73.9375, 40.8303 ]
   },
   "legacy" : [ -73.9375, 40.8303 ],
   "category" : "Stadiums"
}

db.places.aggregate([
   {
     $geoNear: {
        near: { type: "Point", coordinates: [ -73.98142 , 40.71782 ] },
        key: "location",
        distanceField: "dist.calculated",
        query: { "category": "Parks" }
     }
   },
   { $limit: 5 }
])

{
   "_id" : 8,
   "name" : "Sara D. Roosevelt Park",
   "location" : {
      "type" : "Point",
      "coordinates" : [
         -73.9928,
         40.7193
      ]
   },
   "category" : "Parks",
   "dist" : {
      "calculated" : 974.175764916902
   }
}
{
   "_id" : 1,
   "name" : "Central Park",
   "location" : {
      "type" : "Point",
      "coordinates" : [
         -73.97,
         40.77
      ]
   },
   "legacy" : [
      -73.97,
      40.77
   ],
   "category" : "Parks",
   "dist" : {
      "calculated" : 5887.92792958097
   }
}