/ /

/ /

$geoWithin

Definición

$geoWithin

Selecciona documentos con datos geoespaciales que existan completamente dentro de una forma especificada.

La forma especificada puede ser un GeoJSON Polygon (ya sea de un solo anillo o de varios anillos), un GeoJSON MultiPolygon o una forma definida por pares de coordenadas heredados. El $geoWithin El operador utiliza el operador $geometry para especificar el objeto GeoJSON.

Para especificar polígonos o multipolígonos GeoJSON utilizando el sistema de referencia de coordenadas (CRS) predeterminado, utilice la siguiente sintaxis:

{
   <location field>: {
      $geoWithin: {
         $geometry: {
            type: <"Polygon" or "MultiPolygon"> ,
            coordinates: [ <coordinates> ]
         }
      }
   }
}

Para las consultas que especifican geometrías GeoJSON con áreas mayores a un solo hemisferio, el uso del CRS predeterminado da como resultado consultas para las geometrías $geoWithin complementarias.

Para especificar un polígono GeoJSON de un solo anillo con un CRS MongoDB personalizado, utilice el siguiente prototipo que especifica el CRS MongoDB personalizado en la $geometry expresión:

{
   <location field>: {
      $geoWithin: {
         $geometry: {
           type: "Polygon" ,
           coordinates: [ <coordinates> ],
           crs: {
              type: "name",
              properties: { name: "urn:x-mongodb:crs:strictwinding:EPSG:4326" }
           }
         }
      }
   }
}

El CRS personalizado de MongoDB utiliza un orden de giro en sentido antihorario y permite que admita $geoWithin consultas con un polígono GeoJSON de un solo anillo cuya área sea mayor o igual a un hemisferio. Si el polígono especificado es menor que un hemisferio, el comportamiento de $geoWithin con el CRS de MongoDB es el mismo que con el CRS predeterminado. Consulte también Polígonos "Grandes".

Si consulta la inclusión en una forma definida por pares de coordenadas heredadas en un plano, utilice la siguiente sintaxis:

{
   <location field>: {
      $geoWithin: { <shape operator>: <coordinates> }
   }
}

Los operadores de forma disponibles son:

$box,
$polygon,
$center (define un círculo), y
$centerSphere (define un círculo en una esfera).

Importante

Si utiliza longitud y latitud, especifique las coordenadas en orden de longitude, latitude.

Comportamiento

Índices geoespaciales

$geoWithin no requiere un índice geoespacial. Sin embargo, un índice geoespacial mejorará el rendimiento de las consultas. Tanto los índices geoespaciales 2dsphere como 2d $geoWithin admiten.

Resultados no ordenados

El $geoWithin operador no devuelve resultados ordenados. Por lo tanto, MongoDB puede devolver consultas con $geoWithin mayor rapidez que las $near $nearSphere consultas geoespaciales o, que ordenan los resultados.

Geometría degenerada

$geoWithin no garantiza que considerará que una pieza de geometría contiene su geometría componente, u otro polígono que comparte su geometría componente.

Polígonos "grandes"

$geoWithinPara, si especifica un polígono de un solo anillo con un área mayor que un hemisferio, incluya el sistema de referencia de coordenadas MongoDB personalizado en la $geometry expresión. De lo contrario, $geoWithin consulta la geometría complementaria. Para todos los demás polígonos GeoJSON con áreas mayores que un hemisferio, $geoWithin consulta la geometría complementaria.

Ejemplos

Dentro de un polígono

El siguiente ejemplo selecciona todos los loc datos que existen dentro de un GeoJSON. El área del polígono es menor que el área de un Polygon hemisferio:

db.places.find(
   {
     loc: {
       $geoWithin: {
          $geometry: {
             type : "Polygon" ,
             coordinates: [ [ [ 0, 0 ], [ 3, 6 ], [ 6, 1 ], [ 0, 0 ] ] ]
          }
       }
     }
   }
)

Para polígonos de un solo anillo con áreas mayores que un solo hemisferio, consulte Dentro de un polígono "Grande".

Dentro de un polígono "Grande"

Para consultar un polígono GeoJSON de un solo anillo cuya área sea mayor que un hemisferio, la expresión debe especificar el sistema de referencia de coordenadas MongoDB personalizado. Por $geometry ejemplo:

db.places.find(
   {
     loc: {
       $geoWithin: {
          $geometry: {
             type : "Polygon" ,
             coordinates: [
               [
                 [ -100, 60 ], [ -100, 0 ], [ -100, -60 ], [ 100, -60 ], [ 100, 60 ], [ -100, 60 ]
               ]
             ],
             crs: {
                type: "name",
                properties: { name: "urn:x-mongodb:crs:strictwinding:EPSG:4326" }
             }
          }
       }
     }
   }
)

Volver

$geometría

$distanciamáxima