Comment fonctionnent les requêtes géospatiales dans MongoDB?

Question

Accepted Answer

MongoDB dispose d'un support intégré pour **les données et requêtes géospatiales** — stockage de localisations (points, zones) et requêtes par proximité, contenance et intersection. Il utilise les **index 2dsphere** et GeoJSON, alimentant des fonctionnalités comme « trouver des lieux près de moi » sans base de données géospatiale distincte.

## Stockage des données de localisation (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" });
```

Les localisations sont stockées en **GeoJSON** (`{ type: "Point", coordinates: [lng, lat] }` — longitude en premier), et un **index 2dsphere** permet des requêtes géospatiales efficaces sur une sphère (Terre).

## Requêtes de proximité — trouver les lieux proches

```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` trouve les documents près d'un point, retournés dans l'ordre des distances — le fondement des fonctionnalités « à proximité ».

## Contenance et intersection

```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` trouve les documents à l'intérieur d'une zone (polygone/cercle); `$geoIntersects` trouve les géométries qui intersectent une forme — pour les requêtes basées sur les régions.

## Pourquoi c'est important

Le support des requêtes géospatiales est une capacité MongoDB précieuse pour **les fonctionnalités basées sur la localisation**, donc la comprendre est une connaissance utile pour les applications traitant les localisations (cartes, livraison, localisateurs de magasins, covoiturage, points de contrôle sociaux — des fonctionnalités de plus en plus courantes).

La valeur fondamentale est que MongoDB peut stocker **des données géospatiales** (en GeoJSON) et exécuter **des requêtes géospatiales** directement — trouvant les documents par **proximité** (`$near` — « lieux près de moi », triés par distance, le fondement des fonctionnalités de recherche de lieux), **contenance** (`$geoWithin` — documents à l'intérieur d'une zone ou d'un rayon), et **intersection** (`$geoIntersects` — géométries chevauchant une forme) — tout cela rendu efficace par les **index 2dsphere** qui tiennent compte de la géométrie sphérique de la Terre.

Cela signifie que de nombreuses fonctionnalités basées sur la localisation peuvent être construites directement dans MongoDB sans base de données géospatiale spécialisée distincte, simplifiant la pile technologique.

Comprendre les éléments pratiques essentiels — stockage GeoJSON (avec l'ordre des coordonnées longitude-en-premier, une erreur courante), création d'index 2dsphere, et les opérateurs de requête ($near, $geoWithin, $geoIntersects) — permet d'implémenter de vraies fonctionnalités de localisation.

Comme la fonctionnalité basée sur la localisation est un besoin applicatif de plus en plus courant, et comme MongoDB fournit un support géospatial intégré capable (stockage, requêtes de proximité/contenance/intersection, indexation sphérique efficace) qui le traite directement, comprendre les requêtes géospatiales MongoDB — stockage GeoJSON, index 2dsphere, et les opérateurs de proximité/contenance — est une connaissance précieuse et pratiquement pertinente pour construire des applications conscientes des localisations sur MongoDB, une capacité utile pour le besoin courant « trouver des choses près d'une localisation ».