Como funcionam as consultas geoespaciais no MongoDB?

Question

Accepted Answer

O MongoDB possui suporte integrado para **dados e consultas geoespaciais** — armazenar localizações (pontos, áreas) e consultar por proximidade, contenção e interseção. Ele usa **índices 2dsphere** e GeoJSON, alimentando funcionalidades como "encontrar lugares perto de mim" sem um banco de dados geoespacial separado.

## Armazenando dados de localização (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" });
```

As localizações são armazenadas como **GeoJSON** (`{ type: "Point", coordinates: [lng, lat] }` — longitude primeiro), e um **índice 2dsphere** habilita consultas geoespaciais eficientes em uma esfera (Terra).

## Consultas de proximidade — encontrar próximos

```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` encontra documentos próximos a um ponto, retornados em ordem de distância — a base das funcionalidades de "proximidade".

## Contenção e interseção

```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` encontra documentos dentro de uma área (polígono/círculo); `$geoIntersects` encontra geometrias que intersectam uma forma — para consultas baseadas em região.

## Por que isso importa

O suporte a consultas geoespaciais é uma capacidade valiosa do MongoDB para **funcionalidades baseadas em localização**, portanto, entender isso é um conhecimento útil para aplicações que lidam com localizações (mapas, entrega, localizadores de lojas, compartilhamento de viagens, check-ins sociais — funcionalidades cada vez mais comuns).

O valor central é que o MongoDB pode armazenar **dados geoespaciais** (como GeoJSON) e executar **consultas geoespaciais** diretamente — encontrando documentos por **proximidade** (`$near` — "lugares perto de mim", ordenados por distância, a base das funcionalidades de busca de localização), **contenção** (`$geoWithin` — documentos dentro de uma área ou raio), e **interseção** (`$geoIntersects` — geometrias sobrepondo uma forma) — tudo eficiente por **índices 2dsphere** que levam em conta a geometria esférica da Terra.

Isso significa que muitas funcionalidades baseadas em localização podem ser construídas diretamente no MongoDB sem um banco de dados geoespacial especializado separado, simplificando a pilha.

Entender os fundamentos práticos — armazenamento GeoJSON (com a ordem de coordenadas longitude-primeira, uma pegadinha comum), criar índices 2dsphere e os operadores de consulta ($near, $geoWithin, $geoIntersects) — habilita a implementação de funcionalidades reais de localização.

Como a funcionalidade baseada em localização é uma necessidade de aplicação cada vez mais comum, e como o MongoDB fornece suporte geoespacial integrado capaz (armazenamento, consultas de proximidade/contenção/interseção, indexação esférica eficiente) que a trata diretamente, entender consultas geoespaciais do MongoDB — armazenamento GeoJSON, índices 2dsphere e os operadores de proximidade/contenção — é um conhecimento valioso e praticamente relevante para construir aplicações conscientes de localização no MongoDB, uma capacidade útil para o requisito comum de "encontrar coisas perto de uma localização".