$center (query predicate operador)

Definición

$center

El operador $center especifica un círculo para una consulta $geoWithin. La consulta devuelve pares de coordenadas heredados que están dentro de los límites del círculo. El operador no devuelve objetos GeoJSON.

Para utilizar el $center operador, especifique un arreglo que contenga:

• Las coordenadas de la cuadrícula del punto central del círculo, y

• El radio del círculo, medido en las unidades utilizadas por el sistema de coordenadas.

{
   <location field>: {
      $geoWithin: { $center: [ [ <x>, <y> ] , <radius> ] }
   }
}

Importante

Si usa longitud y latitud, debe especificar primero la longitud.

Comportamiento

La query calcula distancias utilizando geometría plana (plana).

Las aplicaciones pueden usar $center sin tener un índice geoespacial. Sin embargo, los índices geoespaciales permiten consultas mucho más rápidas que sus equivalentes no indexados.

Solo el 2d índice geoespacial admite $center.

Ejemplo

La siguiente query de ejemplo devuelve todos los documentos que tienen coordenadas que existen dentro del círculo centrado en [ -74, 40.74 ] y con un radio de 10:

db.places.find(
   { loc: { $geoWithin: { $center: [ [-74, 40.74], 10 ] } } }
)