Menu Docs

Página inicial do DocsDesenvolver aplicaçõesManual do MongoDB

$center

Nesta página

  • Definição
  • Comportamento
  • Exemplo
$center

O operador $center especifica um círculo para uma query $geoWithin . A query retorna pares de coordenadas legados que estão dentro dos limites do círculo. O operador não retorna objetos GeoJSON.

Para utilizar 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.

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.

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 ] } } }
)
← $box