Kuinka geospaciaaliset kyselyt toimivat MongoDBssä?

Question

Accepted Answer

MongoDB:ssä on sisäänrakennettu tuki **geospaciaalisille tiedoille ja kyselyille** — paikkojen (pisteet, alueet) tallentamiselle ja kyselyille läheisyyden, sisältämisen ja leikkauksen perusteella. Se käyttää **2dsphere-indeksejä** ja GeoJSONia, mikä mahdollistaa ominaisuudet kuten "etsi minua lähellä olevat paikat" ilman erillistä geospaciaalista tietokantaa.

## Sijaintitietojen tallentaminen (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" });
```

Sijaintia tallennetaan **GeoJSON**-muodossa (`{ type: "Point", coordinates: [lng, lat] }` — pituuspiiri ensin), ja **2dsphere-indeksi** mahdollistaa tehokkaat geospaciaaliset kyselyt pallolla (Maapallolla).

## Läheisyyskyselyn — etsi lähellä

```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` etsii asiakirjoja pisteen lähellä, palautettu etäisyyden mukaan järjestyksessä — pohja "lähellä" -ominaisuuksille.

## Sisältäminen ja leikkaus

```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` etsii asiakirjoja alueen sisällä (monikulmio/ympyrä); `$geoIntersects` etsii geometrioita, jotka leikkaavat muotoa — aluepohjaisia kyselyitä varten.

## Miksi tämä on tärkeää

Geospaciaalisen kyselyn tuki on arvokas MongoDB-ominaisuus **sijaintipohjaisille ominaisuuksille**, joten sen ymmärtäminen on hyödyllinen tieto sovelluksille, jotka käsittelevät sijainteja (kartat, toimitus, myymäläpaikannitin, kyydipalvelut, sosiaaliset check-init — yhä yleisempiä ominaisuuksia).

Ydinarvona on se, että MongoDB voi tallentaa **geospaciaalisia tietoja** (GeoJSONina) ja suorittaa **geospaciaalisia kyselyitä** suoraan — etsimällä asiakirjoja **läheisyyden** perusteella (`$near` — "paikat minua lähellä", järjestetty etäisyyden mukaan, pohja sijaintihaun ominaisuuksille), **sisältämisen** perusteella (`$geoWithin` — asiakirjat alueen tai säteen sisällä) ja **leikkauksen** perusteella (`$geoIntersects` — geometriat, jotka päällekkäin muoto) — kaikki tehokkaiksi **2dsphere-indekseillä**, jotka ottavat huomioon Maan pallomaisen geometrian.

Tämä tarkoittaa, että monet sijaintipohjaiset ominaisuudet voidaan rakentaa suoraan MongoDBssa ilman erillistä erikoistunutta geospaciaalista tietokantaa, mikä yksinkertaistaa pinoa.

Praktisten perusasioiden ymmärtäminen — GeoJSON-varastointi (pituuspiiri-ensin-koordinaattijärjestyksellä, yleinen sudenkuoppa), 2dsphere-indeksien luominen ja kyselyoperaattorit ($near, $geoWithin, $geoIntersects) — mahdollistaa oikeiden sijaintiominaisuuksien toteuttamisen.

Koska sijaintipohjaiset toiminnot ovat yhä yleisempi sovelluksen tarve, ja koska MongoDB tarjoaa kyvykkään sisäänrakennetun geospaciaalisen tuen (varastointi, läheisyys/sisältäminen/leikkaus-kyselyt, tehokas pallomainen indeksointi), joka käsittelee sen suoraan, MongoDB geospaciaalisten kyselyiden ymmärtäminen — GeoJSON-varastointi, 2dsphere-indeksit ja läheisyys/sisältäminen-operaattorit — on arvokas, käytännöllisesti merkityksellinen tieto sijainnistietävien sovellusten rakentamisesta MongoDBssa, hyödyllinen ominaisuus yleiselle "etsi asioita lähellä sijaintia" -vaatimukselle.