$near

Esta versión de la documentación se archivó y ya no se admite. Para actualizar tu implementación de 6.0, consulta el Procedimientos de actualización de MongoDB.7.0

Definición

$near

Especifica un punto para el que se La query geoespacial devuelve los documentos de más cerca a más lejos. El operador $near puede especificar un punto GeoJSON o un punto de coordenadas heredado.

$near requiere un índice geoespacial:

2dsphere índice si se especifica un punto GeoJSON,
Índice2d si se especifica un punto utilizando coordenadas heredadas.

Para especificar un punto GeoJSON, el operador $near requiere un índice 2dsphere y tiene la siguiente sintaxis:

{
   <location field>: {
     $near: {
       $geometry: {
          type: "Point" ,
          coordinates: [ <longitude> , <latitude> ]
       },
       $maxDistance: <distance in meters>,
       $minDistance: <distance in meters>
     }
   }
}

Importante

Si especifica coordenadas de longitud y latitud, enumera primero la longitud y luego la latitud.

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.

Al especificar un punto GeoJSON, puedes limitar los $maxDistance $near resultados $minDistance de por distancia en metros utilizando las especificaciones opcionales y :

$minDistance limita los resultados a aquellos documentos que están al menos a la distancia especificada del punto central.
$maxDistance limita los resultados a aquellos documentos que se encuentran como máximo a la distancia especificada del punto central.

Para especificar un punto utilizando coordenadas heredadas, $near requiere un índice 2d y tiene la siguiente sintaxis:

{
  $near: [ <x>, <y> ],
  $maxDistance: <distance in radians>
}

Al especificar una coordenada heredada, puedes usar la especificación opcional $maxDistance para limitar los resultados $near por distancia en radianes. $maxDistance limita los resultados a aquellos documentos que se encuentran como máximo a la distancia específica del punto central.

Comportamiento

Restricción de índices especiales

No se puede combinar el operador,$near que requiere un índice geoespacial especial, con un operador o comando de consulta que requiera otro índice especial. Por ejemplo, no se puede combinar $near con la $text consulta.

Operación de Ordenamiento

El operador ordena los documentos por $near distancia.

Si usas el método sort() en tu query, MongoDB realiza una segunda operación de ordenamiento, reorganizando los documentos coincidentes. Al consultar grandes colecciones, esto puede afectar negativamente el rendimiento de la query.
Si el orden de los documentos no es importante para ti, considera usar el operador $geoWithin en su lugar, ya que devuelve resultados no ordenados.
$near es un operador de ejecución Match y no está permitido en los pipelines de agregación.

Ejemplos

Consulta sobre datos GeoJSON

Importante

Si especifica coordenadas de longitud y latitud, enumera primero la longitud y luego la latitud.

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.

Considera una colección places que tenga un índice 2dsphere.

El siguiente ejemplo devuelve documentos que están a al menos 1000 metros y como máximo 5000 metros del punto GeoJSON especificado, ordenados desde el más cercano hasta el más lejano:

db.places.find(
   {
     location:
       { $near :
          {
            $geometry: { type: "Point",  coordinates: [ -73.9667, 40.78 ] },
            $minDistance: 1000,
            $maxDistance: 5000
          }
       }
   }
)

Consulta sobre coordenadas heredadas

Importante

Si especifica coordenadas de longitud y latitud, enumera primero la longitud y luego la latitud.

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.

Considera una colección legacy2d que tenga un índice 2d.

El siguiente ejemplo devuelve los documentos que están a no más de 0.10 radianes del par de coordenadas heredadas especificado, ordenados de más cercano a más lejano:

db.legacy2d.find(
   { location : { $near : [ -73.9667, 40.78 ], $maxDistance: 0.10 } }
)

Volver

$geoWithin

$nearSphere