Come funzionano le query geospaziali in MongoDB?

Question

Accepted Answer

MongoDB ha un supporto integrato per **dati geospaziali e query** — archiviare posizioni (punti, aree) e interrogare per prossimità, contenimento e intersezione. Utilizza **indici 2dsphere** e GeoJSON, abilitando funzionalità come "trova i posti vicini a me" senza un database geospaziale separato.

## Archiviare dati di posizione (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" });
```

Le posizioni sono archiviate come **GeoJSON** (`{ type: "Point", coordinates: [lng, lat] }` — longitudine per primo), e un **indice 2dsphere** abilita query geospaziali efficienti su una sfera (Terra).

## Query di prossimità — trova i vicini

```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` trova documenti vicini a un punto, restituiti in ordine di distanza — la base delle funzionalità "vicino".

## Contenimento e intersezione

```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` trova documenti all'interno di un'area (poligono/cerchio); `$geoIntersects` trova geometrie che intersecano una forma — per query basate su regioni.

## Perché è importante

Il supporto per query geospaziali è una capacità preziosa di MongoDB per **funzionalità basate sulla posizione**, quindi comprenderla è una conoscenza utile per applicazioni che si occupano di posizioni (mappe, consegne, localizzatori di negozi, ride-sharing, check-in social — caratteristiche sempre più comuni).

Il valore fondamentale è che MongoDB può archiviare **dati geospaziali** (come GeoJSON) ed eseguire **query geospaziali** direttamente — trovando documenti per **prossimità** (`$near` — "posti vicini a me", ordinati per distanza, la base delle funzionalità di ricerca per posizione), **contenimento** (`$geoWithin` — documenti all'interno di un'area o raggio), e **intersezione** (`$geoIntersects` — geometrie che si sovrappongono a una forma) — il tutto reso efficiente da **indici 2dsphere** che tengono conto della geometria sferica della Terra.

Ciò significa che molte funzionalità basate sulla posizione possono essere costruite direttamente in MongoDB senza un database geospaziale specializzato separato, semplificando lo stack.

Comprendere gli elementi pratici essenziali — archiviazione GeoJSON (con l'ordine delle coordinate con longitudine per primo, un errore comune), creazione di indici 2dsphere, e gli operatori di query ($near, $geoWithin, $geoIntersects) — abilita l'implementazione di vere funzionalità di posizione.

Poiché la funzionalità basata sulla posizione è un'esigenza applicativa sempre più comune, e poiché MongoDB fornisce un supporto geospaziale integrato capace (archiviazione, query di prossimità/contenimento/intersezione, indicizzazione sferica efficiente) che lo gestisce direttamente, comprendere le query geospaziali di MongoDB — archiviazione GeoJSON, indici 2dsphere, e gli operatori di prossimità/contenimento — è una conoscenza preziosa e praticamente rilevante per costruire applicazioni consapevoli della posizione su MongoDB, una capacità utile per il comune requisito "trova cose vicino a una posizione".