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.