$polygon (operador de predicado de query)

Definición

$polygon

Especifica un polígono para una geoespacial $geoWithin query en legacy coordinate pairs. La query devuelve pares que están dentro de los límites del polígono. El operador no query objetos GeoJSON.

Para definir el polígono, especifica un arreglo de puntos de coordenadas:

{
   <location field>: {
      $geoWithin: {
         $polygon: [ [ <x1> , <y1> ], [ <x2> , <y2> ], [ <x3> , <y3> ], ... ]
      }
   }
}

El último punto siempre está vinculado implícitamente al primero. Puedes especificar tantos puntos, es decir, lados, como desees.

Importante

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

Comportamiento

El operador $polygon calcula distancias utilizando geometría plana (planar).

Las aplicaciones pueden usar $polygon sin necesidad de un índice geoespacial. Sin embargo, los índices geoespaciales permiten realizar consultas mucho más rápidas que sus equivalentes sin índice.

Solo el índice geoespacial 2d admite el operador $polygon.

Ejemplo

La siguiente query devuelve todos los documentos que tienen coordenadas dentro del polígono definido por [ 0 , 0 ], [ 3 , 6 ] y [ 6 , 0 ]:

db.places.find(
  {
     loc: {
       $geoWithin: { $polygon: [ [ 0 , 0 ], [ 3 , 6 ], [ 6 , 0 ] ] }
     }
  }
)