¿Cómo funcionan las consultas geoespaciales en MongoDB?

Question

Accepted Answer

MongoDB tiene soporte integrado para **datos y consultas geoespaciales** — almacenando ubicaciones (puntos, áreas) y consultando por proximidad, contención e intersección. Utiliza **índices 2dsphere** y GeoJSON, permitiendo funcionalidades como "encontrar lugares cerca de mí" sin necesidad de una base de datos geoespacial separada.

## Almacenamiento de datos de ubicación (GeoJSON)

```js
// store locations as GeoJSON points: [longitude, latitude] (note the order!)
db.places.insertOne({
  name: "Cafe",
  location: { type: "Point", coordinates: [-73.97, 40.77] }   // [lng, lat]
});

// create a 2dsphere index to enable geospatial queries
db.places.createIndex({ location: "2dsphere" });
```

Las ubicaciones se almacenan como **GeoJSON** (`{ type: "Point", coordinates: [lng, lat] }` — longitud primero), e un **índice 2dsphere** permite consultas geoespaciales eficientes en una esfera (Tierra).

## Consultas de proximidad — encontrar cercanos

```js
// $near — find documents near a point, SORTED by distance
db.places.find({
  location: {
    $near: {
      $geometry: { type: "Point", coordinates: [-73.97, 40.77] },
      $maxDistance: 1000        // within 1000 meters
    }
  }
});
// → results ordered nearest-first (great for "places near me")
```

`$near` encuentra documentos cerca de un punto, devueltos en orden de distancia — la base de las funcionalidades "cercanos".

## Contención e intersección

```js
// $geoWithin — find documents INSIDE an area (polygon, circle)
db.places.find({
  location: {
    $geoWithin: {
      $centerSphere: [[-73.97, 40.77], 5 / 6378.1]   // within 5km radius
    }
  }
});

// $geoIntersects — find documents whose geometry intersects a given shape
db.zones.find({ area: { $geoIntersects: { $geometry: somePolygon } } });
```

`$geoWithin` encuentra documentos dentro de un área (polígono/círculo); `$geoIntersects` encuentra geometrías que intersectan una forma — para consultas basadas en regiones.

## Por qué es importante

El soporte de consultas geoespaciales es una capacidad valiosa de MongoDB para **funcionalidades basadas en ubicación**, por lo que comprenderlo es conocimiento útil para aplicaciones que tratan con ubicaciones (mapas, entregas, localizador de tiendas, viajes compartidos, check-ins sociales — características cada vez más comunes).

El valor principal es que MongoDB puede almacenar **datos geoespaciales** (como GeoJSON) y ejecutar **consultas geoespaciales** directamente — encontrando documentos por **proximidad** (`$near` — "lugares cerca de mí", ordenados por distancia, la base de funcionalidades de búsqueda de ubicación), **contención** (`$geoWithin` — documentos dentro de un área o radio), e **intersección** (`$geoIntersects` — geometrías que se superponen con una forma) — todo hecho eficiente por **índices 2dsphere** que cuentan con la geometría esférica de la Tierra.

Esto significa que muchas funcionalidades basadas en ubicación se pueden construir directamente en MongoDB sin una base de datos geoespacial especializada separada, simplificando la arquitectura.

Comprender los conceptos prácticos esenciales — almacenamiento GeoJSON (con el orden de coordenadas longitud-primero, un error común), crear índices 2dsphere, y los operadores de consulta ($near, $geoWithin, $geoIntersects) — permite implementar funcionalidades de ubicación reales.

Ya que la funcionalidad basada en ubicación es una necesidad de aplicación cada vez más común, y MongoDB proporciona soporte geoespacial integrado capaz (almacenamiento, consultas de proximidad/contención/intersección, indexación esférica eficiente) que lo maneja directamente, entender consultas geoespaciales de MongoDB — almacenamiento GeoJSON, índices 2dsphere, y operadores de proximidad/contención — es conocimiento valioso y práctico-relevante para construir aplicaciones conscientes de ubicación en MongoDB, una capacidad útil para el requisito común "encontrar cosas cerca de una ubicación".