$center

Definição

$center

O operador $center especifica um círculo para uma query $geoWithin . A query retorna legacy coordinate pairs que estão dentro dos limites do círculo. O operador não retorna objetos GeoJSON.

Para usar o operador $center, especifique uma array que contenha:

• As coordenadas de grade do ponto central do círculo, e

• O raio do círculo, conforme medido nas unidades usadas pelo sistema de coordenadas.

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

Importante

Se você utilizar longitude e latitude, especifique longitude primeiro.

Comportamento

A query calcula distâncias utilizando geometria plana (planar).

Os aplicativos podem utilizar o $center sem ter um índice geoespacial. No entanto, os índices geoespaciais suportam queries muito mais rápidas do que os equivalentes não indexados.

Somente o índice geoespacial 2d suporta $center.

Exemplo

A seguinte query de exemplo retorna todos os documentos que têm coordenadas que existem dentro do círculo centralizado em [ -74, 40.74 ] e com um raio de 10:

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