Les recherches géospatiales

Stocker un lieu : le format GeoJSON

On stocke une position dans un champ au format GeoJSON : un objet { type, coordinates }. Attention à l'ordre : longitude d'abord, puis latitude.

{
  "zone": "Ladignac-le-Long",
  "localisation": {
    "type": "Point",
    "coordinates": [ 1.1367, 45.6006 ]   // [lon, lat]
  }
}

L'index 2dsphere

Les requêtes géospatiales exigent un index 2dsphere sur le champ de localisation (il modélise la Terre comme une sphère).

db.campagnes.createIndex({ localisation: "2dsphere" })

$near — les plus proches

$near renvoie les documents triés du plus proche au plus lointain d'un point, avec une distance maximale (en mètres).

db.campagnes.find({
  localisation: {
    $near: {
      $geometry: { type: "Point", coordinates: [1.1367, 45.6006] },
      $maxDistance: 20000            // 20 km
    }
  }
})

$geoWithin — à l'intérieur d'une zone

$geoWithin renvoie les points situés dans une forme (cercle, polygone). Ici, un cercle défini par un centre et un rayon en radians.

db.campagnes.find({
  localisation: {
    $geoWithin: {
      $centerSphere: [ [1.1367, 45.6006], 20/6378.1 ]  // 20 km / rayon Terre
    }
  }
})

$geoIntersects — qui croise une forme

$geoIntersects renvoie les documents dont la géométrie croise un polygone donné — utile pour « quels points tombent dans le périmètre de cette commune ? » (défini par un polygone).

db.campagnes.find({
  localisation: {
    $geoIntersects: {
      $geometry: { type: "Polygon", coordinates: [ [ /* sommets */ ] ] }
    }
  }
})

Application au fil rouge

La géolocalisation donne à l'appli une fonctionnalité forte : proposer au particulier les campagnes autour de lui.