Bagaimana cara kerja kueri geospasial di MongoDB?

Question

Accepted Answer

MongoDB memiliki dukungan bawaan untuk **data dan kueri geospasial** — menyimpan lokasi (titik, area) dan melakukan kueri berdasarkan kedekatan, keberadaan, dan perpotongan. MongoDB menggunakan **indeks 2dsphere** dan GeoJSON, yang mendukung fitur seperti "cari tempat di dekat saya" tanpa memerlukan database geospasial terpisah.

## Menyimpan data lokasi (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" });
```

Lokasi disimpan sebagai **GeoJSON** (`{ type: "Point", coordinates: [lng, lat] }` — bujur terlebih dahulu), dan **indeks 2dsphere** memungkinkan kueri geospasial yang efisien pada bola (Bumi).

## Kueri kedekatan — cari yang terdekat

```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` menemukan dokumen dekat dengan suatu titik, yang dikembalikan berdasarkan urutan jarak — fondasi dari fitur "terdekat".

## Keberadaan dan perpotongan

```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` menemukan dokumen di dalam suatu area (poligon/lingkaran); `$geoIntersects` menemukan geometri yang berpotongan dengan suatu bentuk — untuk kueri berbasis wilayah.

## Mengapa ini penting

Dukungan kueri geospasial adalah kemampuan MongoDB yang berharga untuk **fitur berbasis lokasi**, sehingga memahaminya adalah pengetahuan yang berguna untuk aplikasi yang menangani lokasi (peta, pengiriman, pencari toko, ride-sharing, check-in sosial — fitur yang semakin umum).

Nilai inti adalah MongoDB dapat menyimpan **data geospasial** (sebagai GeoJSON) dan menjalankan **kueri geospasial** secara langsung — menemukan dokumen berdasarkan **kedekatan** (`$near` — "tempat dekat saya", diurutkan berdasarkan jarak, fondasi fitur pencarian lokasi), **keberadaan** (`$geoWithin` — dokumen di dalam area atau radius), dan **perpotongan** (`$geoIntersects` — geometri yang tumpang tindih dengan suatu bentuk) — semuanya dibuat efisien oleh **indeks 2dsphere** yang memperhitungkan geometri bola Bumi.

Ini berarti banyak fitur berbasis lokasi dapat dibangun langsung di MongoDB tanpa database geospasial khusus yang terpisah, menyederhanakan stack.

Memahami esensi praktis — penyimpanan GeoJSON (dengan urutan koordinat bujur terlebih dahulu, sebuah gotcha umum), membuat indeks 2dsphere, dan operator kueri ($near, $geoWithin, $geoIntersects) — memungkinkan penerapan fitur lokasi nyata.

Karena fungsionalitas berbasis lokasi adalah kebutuhan aplikasi yang semakin umum, dan karena MongoDB menyediakan dukungan geospasial bawaan yang mampu (penyimpanan, kueri kedekatan/keberadaan/perpotongan, pengindeksan bola yang efisien) yang menanganinya secara langsung, memahami kueri geospasial MongoDB — penyimpanan GeoJSON, indeks 2dsphere, dan operator kedekatan/keberadaan — adalah pengetahuan yang berharga dan relevan secara praktis untuk membangun aplikasi yang menyadari lokasi di MongoDB, sebuah kemampuan yang berguna untuk kebutuhan umum "temukan hal-hal di dekat suatu lokasi".