Suite de « Mes lieux ». La recherche par rayon a un défaut connu de tous ceux qui font du maillage : 10 km à vol d'oiseau, ce n'est pas la même chose des deux côtés d'un fleuve, d'une voie ferrée ou d'un massif. Un point de vente à 4 km peut demander 25 minutes ; un autre à 12 km peut être à 10 minutes par la rocade.

La recherche dans votre référentiel accepte donc une seconde façon de définir la portée : une durée de trajet.

curl -s -G "https://api.trustydata.app/services/v1/locations/search" \
  -H "Authorization: Bearer VOTRE_CLE" \
  --data-urlencode "referentiel=boutiques" \
  --data-urlencode "adresse=12 rue de la République, Lyon" \
  --data-urlencode "duree=15" \
  --data-urlencode "mode=pieton"

« Mes boutiques à moins de 15 minutes à pied de ce point. »

Les trois modes de déplacement

mode accepte auto (par défaut), pieton et velo. Ce n'est pas un détail cosmétique : une zone de chalandise piétonne de 15 minutes en centre-ville et une zone routière de 15 minutes en périphérie décrivent deux commerces qui n'ont rien à voir. Le calcul suit le réseau réel — rues à sens unique pour la voiture, chemins et zones piétonnes pour la marche.

La durée va de 1 à 30 minutes. duree et rayon sont exclusifs l'un de l'autre : une recherche a une portée, et une seule.

Le contour, si vous voulez le dessiner

polygone=true ajoute le contour de l'isochrone dans portee.polygone. De quoi tracer la zone sur votre propre carte, ou l'archiver pour comparer deux implantations. Comptez 10 à 20 Ko : à ne demander que quand vous en avez l'usage.

Deux précisions qui évitent les mauvaises surprises

Le tri reste à vol d'oiseau. Y compris avec distances=true, qui ajoute la distance et la durée routières aux 25 premiers résultats : ces deux champs enrichissent la page rendue, ils ne la réordonnent pas. Le filtre est routier, le classement est géométrique — si vous affichez « le plus proche », dites bien de quelle proximité vous parlez.

L'attribution OpenStreetMap (ODbL) est obligatoire dès que le calcul d'itinéraire est sollicité : avec une duree, mais aussi avec distances=true sur une recherche par rayon. Le champ attribution de la réponse porte la mention exacte à afficher.

Disponibilité

La portée par durée, les distances routières et les étiquettes demandent le plan Growth. La recherche par rayon reste ouverte dès Starter.

Disponible depuis la version 1.5 de la plateforme (GET /version, champ platform).

Le guide : https://trustydata.fr/docs/lieux.html

Dites-nous

  • Quelle durée est la bonne unité chez vous — 10, 15, 30 minutes ? Le plafond actuel est à 30.
  • Est-ce que le contour vous intéresse pour l'afficher, ou seulement la liste des sites qu'il contient ?
  • Un mode transports en commun aurait-il un usage réel de votre côté ? Il demanderait des données horaires que nous n'avons pas aujourd'hui, donc autant savoir si la demande existe avant d'aller les chercher.

Vos retours passent par la page de contact.