$centerSphere (query predicate operador)

Definición

$centerSphere

Define un círculo para una geoespacial query que utiliza geometría esférica. La query devuelve los documentos que están dentro de los límites del círculo. Puedes usar el operador $centerSphere tanto en objetos GeoJSON como en legacy coordinate pairs.

Para utilizar $centerSphere, especifica un arreglo que contenga:

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

• El radio del círculo medido en radianes. Para calcular radianes, consulte Convertir distancia a radianes para operadores esféricos.

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

Importante

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

Comportamiento

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

Tanto 2dsphere como 2d los índices geoespaciales admiten $centerSphere.

Ejemplo

El siguiente ejemplo query las coordenadas de la cuadrícula y devuelve todos los documentos dentro de un radio de 10 millas de longitud 88 W y latitud 30 N. La query convierte la distancia a radianes dividiéndola por el radio ecuatorial aproximado de la tierra, 3963,2 millas:

db.places.find( {
  loc: { $geoWithin: { $centerSphere: [ [ -88, 30 ], 10/3963.2 ] } }
} )