Skip to main content

Documentation Index

Fetch the complete documentation index at: https://doc.fluximmo.io/llms.txt

Use this file to discover all available pages before exploring further.

Le filtre location[] est un tableau : chaque entrée définit une zone, et les zones sont combinées en OR côté moteur (bool.should Elasticsearch). Vous disposez de 6 modes : 4 administratifs (codes) et 2 géométriques (lat/lng).

​
Vue d’ensemble

CatégorieModeChampQuand l’utiliser
AdministratifCode postalpostalCodeZone connue par CP
AdministratifCode INSEEinseeCodeIdentifiant commune unique (5 chars)
AdministratifDépartementdepartmentZone large (ex. "75")
AdministratifVillecity⚠️ ignoré
GéométriqueBounding boxlocationCoordinate.location.geoBoundingBoxCarte interactive (viewport)
GéométriqueRayonlocationCoordinate.location.geoDistance”Tout dans X km autour de Y”

​
Modes administratifs

​
Code postal

{ "location": [{ "postalCode": "75011" }] }

​
Code INSEE

{ "location": [{ "inseeCode": "75056" }] }

​
Département

{ "location": [{ "department": "75" }] }

​
Ville (⚠️ ignoré)

​
Modes géométriques

​
geoBoundingBox — rectangle latitude/longitude

{
  "location": [{
    "locationCoordinate": {
      "location": {
        "geoBoundingBox": {
          "topLeft":     { "lat": 48.9020, "lon": 2.2240 },
          "bottomRight": { "lat": 48.8155, "lon": 2.4699 }
        }
      }
    }
  }]
}
Contraintes :
  • topLeft.lat > bottomRight.lat (latitude croît vers le nord).
  • topLeft.lon < bottomRight.lon (longitude croît vers l’est).
Une bbox inversée ne lève pas d’erreur côté moteur mais retourne 0 résultat.

​
geoDistance — rayon autour d’un point

{
  "location": [{
    "locationCoordinate": {
      "location": {
        "geoDistance": {
          "pin": { "lat": 48.8584, "lon": 2.2945 },
          "distanceKm": 20
        }
      }
    }
  }]
}

​
Multi-zones — logique OR

location étant un array, chaque entrée est combinée en OR (bool.should Elasticsearch). Mélangez librement les modes : 
{
  "location": [
    { "postalCode": "75011" },
    { "department": "92" },
    { "department": "93" },
    {
      "locationCoordinate": {
        "location": {
          "geoDistance": { "pin": { "lat": 48.8584, "lon": 2.2945 }, "distanceKm": 5 }
        }
      }
    }
  ]
}
→ Résultats : Paris 11e OU 92 OU 93 OU 5 km autour de la Tour Eiffel.

​
Quel mode choisir ?

​
Anti-patterns

  • distanceKm = 0 ou négatif → erreur ou 0 résultat selon le mode.
  • Bbox inversée (topLeft.lat < bottomRight.lat) → 0 résultat.
  • Mixer postalCode et city dans la même entrée → city est ignoré, donc le postalCode prend le dessus, mais c’est ambigu. Choisissez un mode par entrée.

​
Pour aller plus loin