Cum funcționează interogările geospațiale în MongoDB?

Question

Accepted Answer

MongoDB are suport încorporat pentru **date și interogări geospațiale** — stocarea locațiilor (puncte, zone) și interogarea după proximitate, conținere și intersecție. Folosește **indecși 2dsphere** și GeoJSON, alimentând funcții precum "găsește locuri lângă mine" fără o bază de date geospațială separată.

## Stocarea datelor de locație (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" });
```

Locațiile sunt stocate ca **GeoJSON** (`{ type: "Point", coordinates: [lng, lat] }` — longitudinea mai întâi), iar un **indice 2dsphere** permite interogări geospațiale eficiente pe o sferă (Pământul).

## Interogări de proximitate — găsește locuri apropiate

```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` găsește documente lângă un punct, returnate în ordinea distanței — fundația funciilor "apropiate".

## Conținere și intersecție

```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` găsește documente în interiorul unei zone (poligon/cerc); `$geoIntersects` găsește geometrii care intersectează o formă — pentru interogări bazate pe regiuni.

## De ce este important

Suportul pentru interogări geospațiale este o capacitate valoroasă a MongoDB pentru **funcții bazate pe locație**, deci înțelegerea acesteia este cunoaștere utilă pentru aplicații care se ocupă de locații (hărți, livrări, locator de magazine, ride-sharing, check-in-uri sociale — funcții din ce în ce mai comune).

Valoarea principală constă în faptul că MongoDB poate stoca **date geospațiale** (ca GeoJSON) și rula **interogări geospațiale** direct — găsind documente după **proximitate** (`$near` — "locuri lângă mine", sortate după distanță, fundația funciilor de căutare de locație), **conținere** (`$geoWithin` — documente în interiorul unei zone sau raze) și **intersecție** (`$geoIntersects` — geometrii care se suprapun cu o formă) — toate făcute eficiente prin **indecși 2dsphere** care iau în considerare geometria sferică a Pământului.

Aceasta înseamnă că multe funcții bazate pe locație pot fi construite direct în MongoDB fără o bază de date geospațială separată specializată, simplificând stiva.

Înțelegerea elementelor practice esențiale — stocarea GeoJSON (cu ordinea coordonatelor de la longitudinea la început, o greșeală comună), crearea indicilor 2dsphere și operatorii de interogare ($near, $geoWithin, $geoIntersects) — permite implementarea funciilor reale de locație.

Deoarece funcționalitatea bazată pe locație este o nevoie din ce în ce mai comună pentru aplicații, iar MongoDB furnizează suport geospațial capabil și încorporat (stocarea, interogări de proximitate/conținere/intersecție, indexare sferică eficientă) care o gestionează direct, înțelegerea interogărilor geospațiale MongoDB — stocarea GeoJSON, indecși 2dsphere și operatorii de proximitate/conținere — este cunoaștere valoroasă și practic relevantă pentru construirea aplicațiilor care sunt conștiente de locație pe MongoDB, o capacitate utilă pentru cerința comună "găsește lucruri lângă o locație".