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

Vue d’ensemble

Modes administratifs

Code postal

Code INSEE

Département

Ville (⚠️ ignoré)

Modes géométriques

geoBoundingBox — rectangle latitude/longitude

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

Multi-zones — logique OR

location étant un array, chaque entrée est combinée en OR. Mélangez librement les modes :
→ Résultats : Paris 11e OU 92 OU 93 OU 5 km autour de la Tour Eiffel.
Différence PROPERTY vs ADVERT : côté /properties/search et /properties/search/alerts, location est un array (multi-zones OR). Côté /adverts/search et /adverts/search/alerts, location est un objet unique — pour cibler plusieurs zones côté advert, créez une alerte par zone. Cf Property vs Advert.

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éecity est ignoré, donc le postalCode prend le dessus, mais c’est ambigu. Choisissez un mode par entrée.

Pour aller plus loin