Si funksionojnë pyetjet gjeospatiale në MongoDB?

Question

Accepted Answer

MongoDB ka mbështetje të brendshme për **të dhënat gjeospatiale dhe pyetjet** — ruajtjen e vendndodhjeve (pika, zona) dhe kërkimin sipas afërsisë, përfshirjes dhe kryqëzimit. Përdor **indeksat 2dsphere** dhe GeoJSON, duke fuqizuar veçoritë si "gjeji vendet pranë meje" pa një bazë të dhënash gjeospatiale të veçantë.

## Ruajtja e të dhënave të vendndodhjes (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" });
```

Vendndodhjjet ruhen si **GeoJSON** (`{ type: "Point", coordinates: [lng, lat] }` — gjatësia gjeografike e parë), dhe një **indeks 2dsphere** mundëson pyetje efikase gjeospatiale në një sferë (Tokë).

## Pyetjet e afërsisë — gjeji të afërmit

```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` gjen dokumentet pranë një pike, të kthyera sipas rendit të distancës — themeli i veçorive "të afërmit".

## Përfshirja dhe kryqëzimi

```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` gjen dokumentet brenda një zone (shumëkëndësh/rreth); `$geoIntersects` gjen gjeometritë që kryqëzohen me një formë — për pyetje të bazuara në rajon.

## Pse ka rëndësi

Mbështetja për pyetje gjeospatiale është një aftësi e vlefshme e MongoDB për **veçoritë e bazuara në vendndodhje**, kështu që të kuptimit të saj është njohuri e dobishme për aplikacionet që merren me vendndodhjez (harta, shpërndarje, kërkues dyqani, ndarje udhëtimi, kontroll shoqëror — veçori gjithnjë e më të zakonshme).

Vlera bazë është se MongoDB mund të ruaj **të dhëna gjeospatiale** (si GeoJSON) dhe të ekzekutoj **pyetje gjeospatiale** drejtpërdrejt — gjetja e dokumenteve sipas **afërsisë** (`$near` — "vendet pranë meje", të renditura sipas distancës, themeli i veçorive të kërkimit të vendndodhjes), **përfshirjes** (`$geoWithin` — dokumentet brenda një zone ose rreze), dhe **kryqëzimit** (`$geoIntersects` — gjeometritë që mbivendosen me një formë) — të gjitha të bëra efikase nga **indeksat 2dsphere** që marrin në konsideratë gjeometrinë sferike të Tokës.

Kjo do të thotë që shumë veçori të bazuara në vendndodhje mund të ndërtohen drejtpërdrejt në MongoDB pa një bazë të dhënash të specializuara gjeospatiale, duke thjeshtuar grumbullin.

Të kuptuarit e të importanteve praktike — ruajtja GeoJSON (me rendin koordinat gjatësi-e-parë, një gabim i zakonshëm), krijimi i indeksave 2dsphere, dhe operatorët e pyetjeve ($near, $geoWithin, $geoIntersects) — mundëson zbatimin e veçorive të vërteta të vendndodhjes.

Meqë funksionaliteti i bazuar në vendndodhje është një nevojë e aplikacionit gjithnjë e më e zakonshme, dhe meqë MongoDB ofron mbështetje gjeospatiale të aftë të brendshme (ruajtje, pyetje afërsie/përfshirjeje/kryqëzimi, indeksim sferik efikas) që e menaxhon atë drejtpërdrejt, të kuptimi i pyetjeve gjeospatiale MongoDB — ruajtja GeoJSON, indeksat 2dsphere, dhe operatorët e afërsisë/përfshirjes — është njohuri e vlefshme, praktikisht-relevante për ndërtimin e aplikacioneve të vetëdijshme për vendndodhjen në MongoDB, një aftësi e dobishme për kërkesën e zakonshme "gjeji gjëra pranë një vendndodhje".