Kif jaħdmu l-query ġeospazjali f'MongoDB?

Question

Accepted Answer

MongoDB għandha appoġġ integrat għal **data u query ġeospazjali** — tħaffin lokazzjonijiet (punti, żoni) u tinterfogħa bil-viċinanza, inklużjoni, u intersezzjoni. Tuża **2dsphere indexes** u GeoJSON, li jgħawdu features bħal "sib postijiet ħdejni" mingħajr database ġeospazjali separata.

## Tħaffin data tal-lokazzjoni (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" });
```

Lokazzjonijiet jiġu maħfuża bħala **GeoJSON** (`{ type: "Point", coordinates: [lng, lat] }` — longitude l-ewwel), u **2dsphere index** jiffaċilita query ġeospazjali effiċjenti fuq sfera (Dinja).

## Query tal-viċinanza — sib qarib

```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` jsib dokumenti ħdejn punt, irreturnaħ skond id-distanza — il-pedament ta' features "qarib".

## Inklużjoni u intersezzjoni

```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` jsib dokumenti ġewwa żona (poligonu/ċirku); `$geoIntersects` jsib ġeometriji li jintersekkaw forma — għal query ibbażati fuq reġjun.

## Għalfejn hija importanti

Il-appoġġ tal-query ġeospazjali huwa kapaċità prezjuża ta' MongoDB għal **features ibbażati fuq lokazzjoni**, għalhekk il-fehim tiegħu huwa għaruf utli għal applikazzjonijiet li jonqsu ma' lokazzjonijiet (mapep, konsenja, locator tal-ħwienet, ride-sharing, social check-ins — features kull ħin iktar komuni).

Il-valur ewlieni huwa li MongoDB tista' **tħaffin data ġeospazjali** (bħala GeoJSON) u tħaddem **query ġeospazjali** direttament — sib dokumenti skond **viċinanza** (`$near` — "postijiet ħdejni", sorti skond id-distanza, il-pedament ta' feature ta' tfittxija tal-lokazzjoni), **inklużjoni** (`$geoWithin` — dokumenti ġewwa żona jew radius), u **intersezzjoni** (`$geoIntersects` — ġeometriji li jikkoinċidu ma' forma) — kollha magħmula effiċjenti minn **2dsphere indexes** li jikkunsidraw il-ġeometrija sferika tad-Dinja.

Dan ifisser li ħafna features ibbażati fuq lokazzjoni jistgħu jiġu mibnija direttament f'MongoDB mingħajr database ġeospazjali speċjalizzat separata, u semplifika l-stack.

Il-fehim tal-essenzjali prattiċi — tħaffin GeoJSON (bl-ordni tal-koordinati longitude-ewwel, gotcha komun), ħolqien 2dsphere indexes, u l-operator ta' query ($near, $geoWithin, $geoIntersects) — jippermetti l-implimentazzjoni ta' features ta' lokazzjoni reali.

Billi l-funzjonalità bbażata fuq lokazzjoni hija ħtieġa ta' applikazzjoni kull ħin aktar komuni, u billi MongoDB tipprovdi appoġġ ġeospazjali integrat kapaċ (tħaffin, query tal-viċinanza/inklużjoni/intersezzjoni, indexing sferiċi effiċjenti) li jwieġibeha direttament, il-fehim tal-query ġeospazjali ta' MongoDB — tħaffin GeoJSON, 2dsphere indexes, u l-operator tal-viċinanza/inklużjoni — huwa għaruf valwuż, prattikament rilevanti għall-bini ta' applikazzjonijiet li jidentifikaw il-lokazzjoni fuq MongoDB, kapaċità utli għar-rekwiżit komun "sib ħaġat ħdejn lokazzjoni".