Comment fonctionne la recherche par rayon géographique ?

L'API prend en entrée un point central — des coordonnées GPS (latitude/longitude) ou une adresse libre — et un rayon en mètres (jusqu'à 50 km). Elle retourne les adresses de la Base Adresse Nationale (BAN) situées dans ce rayon, triées par distance croissante.

Puis-je utiliser une adresse comme point central, sans coordonnées GPS ?

Oui. Fournissez une adresse libre via le paramètre adresse : elle est résolue contre la BAN et le meilleur candidat devient le centre de recherche, renvoyé dans point_central.adresse_resolue. Vous pouvez aussi passer directement des coordonnées lat/lon.

Quelle est la distance maximale supportée ?

Le rayon maximum est de 50 km. Les résultats sont paginés (100 adresses par page par défaut, 200 au maximum), jusqu'à 5 000 adresses parcourables par recherche ; suivez pagination.next_offset pour itérer. Pour couvrir de plus grandes zones, multipliez les points de recherche.

Les résultats sont-ils triés par distance ?

Oui, les résultats sont retournés triés par distance croissante par défaut. Chaque résultat inclut le champ distance_m indiquant la distance en mètres à vol d'oiseau depuis le point central. Pour des distances et temps de trajet routiers, utilisez le service de calcul d'itinéraire.

Puis-je limiter le nombre de résultats retournés ?

Oui, le paramètre limit fixe la taille de page (100 par défaut, 200 au maximum). Au-delà, la pagination via pagination.next_offset permet de parcourir jusqu'à 5 000 adresses.

Service

Listez toutes les adresses autour d'un point, triées par distance

Un appel API renvoie les adresses françaises situées dans un rayon défini autour d'un point — coordonnées GPS ou simple adresse — parmi les 26 millions d'adresses de la Base Adresse Nationale.

Tester la démo Voir les formules

Pourquoi c'est compliqué

Calculer des distances à partir d'une base d'adresses nécessite un SIG ou PostGIS
Les APIs de proximité propriétaires facturent à la requête et à l'échelle
Maintenir une base spatiale à jour est coûteux et chronophage
Les solutions maison peinent à gérer des millions d'adresses efficacement

Ce que fait TrustyData

Recherche dans un rayon de 0 à 50 km autour d'un point GPS ou d'une adresse
Résultats triés par distance croissante (à vol d'oiseau), avec distance_m par adresse
Base adresse complète : 26 millions d'adresses françaises (BAN)
Paramètre limit pour contrôler le nombre de résultats
Réponse en une à deux secondes, sans base spatiale (SIG/PostGIS) à héberger

Fonctionnement

Comment fonctionne la recherche de proximité

Le service repose sur un index géographique construit sur les 26 millions d'adresses de la Base Adresse Nationale (BAN). L'appel se déroule en trois étapes :

1
Vous fournissez un point central — coordonnées GPS (lat/lon) ou une adresse libre — et un rayon en mètres (jusqu'à 50 km). Une adresse est résolue contre la BAN avant la recherche.
2
L'API interroge l'index géographique et sélectionne toutes les adresses BAN comprises dans ce rayon.
3
Les résultats sont retournés en JSON, triés par distance croissante, avec le champ distance_m pour chaque adresse.

Aucune requête géospatiale à écrire, aucun calcul de distance côté client : un seul appel renvoie les adresses du rayon, déjà triées par distance, en une à deux secondes.

Démo API

Exemple de requête / réponse

Les adresses dans un rayon de 150 m autour d'un point — ici résolu depuis une adresse. Résultats triés par distance, enrichis selon le plan (position et géocodage IRIS dès Growth).

Requête

GET /v1/address/proximity
    ?adresse=1 place Bellecour 69002 Lyon
    &rayon=150
    &limit=2

Réponse JSON

{
  "point_central": {
    "lat": 45.758884,
    "lon": 4.830916,
    "adresse_resolue": "1 Place Bellecour, 69002 Lyon 2e Arrondissement"
  },
  "resultats": [
    {
      "distance_m": 18,
      "adresse": "2 Place Bellecour, 69002 Lyon 2e Arrondissement",
      "code_postal": "69002",
      "nom_commune": "Lyon 2e Arrondissement",
      "code_insee": "69382",
      "id_ban": "69382_0805_00002",
      "position": { "lat": 45.758826, "lon": 4.831127, "type_position": "entrée" },
      "geocoding": { "code_iris": "693820202", "nom_iris": "Bellecour-Antonin Gourju" }
    },
    {
      "distance_m": 22,
      "adresse": "3 Rue Colonel Chambonnet, 69002 Lyon 2e Arrondissement",
      "code_postal": "69002",
      "nom_commune": "Lyon 2e Arrondissement",
      "code_insee": "69382",
      "id_ban": "69382_1800_00003",
      "position": { "lat": 45.758955, "lon": 4.830655, "type_position": "entrée" },
      "geocoding": { "code_iris": "693820202", "nom_iris": "Bellecour-Antonin Gourju" }
    }
  ],
  "pagination": { "offset": 0, "limit": 2, "total_estime": 82, "next_offset": 2 }
}

Tester la démo interactive →

Données fournies

Champs retournés par l'API

Les champs retournés dépendent du plan souscrit.

Coordonnées Dès Starter

Coordonnées GPS WGS84 et Lambert 93 de l'adresse

Adresse Discovery - Gratuit

Adresse vérifieée et complète

score Discovery - Gratuit

Indice de confiance de 0 à 1

Détail de l'adresse Discovery - Gratuit

Numéro, la voie, le code postal, le lieu-dit et la commune.

Informations officielles Discovery - Gratuit

Code INSEE, code FANTOIR et la certification de la commune.

Géocodage IRIS Dès Growth

Code et nom de l'IRIS.

CarroyageBusiness

Code carreau 200m.

Infos socio-démoBusiness

Indice de pauvreté, le nombre de ménages, tranche d'âge, etc.

Cas d'usage

Secteurs qui utilisent la recherche de proximité

Marketing local

Cibler par zone de chalandise

Identifiez toutes les adresses dans le rayon de vos points de vente pour des campagnes courrier, des opérations de street marketing ou du ciblage géodémographique. Définissez plusieurs rayons concentriques (2, 5, 10 km) pour segmenter vos prospects par proximité. En combinant les résultats avec le géocodage IRIS, vous accédez aux données socio-démographiques Filosofi de chaque zone : revenu médian, densité de ménages, tranches d'âge — de quoi prioriser les zones à arroser.

Immobilier & Services à domicile

Propositions de services de proximité

Affichez les biens, agences ou prestataires les plus proches d'une adresse saisie par l'utilisateur. Améliorez l'expérience de recherche en triant dynamiquement les résultats par distance géographique et non par ordre alphabétique ou date de création. Pour les services à domicile (aide à la personne, maintenance, livraison), ce mécanisme permet d'affecter automatiquement l'intervenant le plus proche d'une demande entrante, sans calcul SIG côté applicatif.

Sécurité & Urgences

Localiser les ressources à proximité

Recensez les ressources (défibrillateurs, casernes, pharmacies de garde) dans un périmètre défini autour d'un point. L'API retourne les points les plus proches triés par distance croissante, avec coordonnées GPS précises — de quoi alimenter une carte opérationnelle, un plan de prévention ou un inventaire de couverture, sans infrastructure géographique à maintenir en local.

Logistique & Livraison du dernier kilomètre

Regrouper les livraisons par zone

Identifiez toutes les adresses à livrer dans un rayon défini autour de chaque dépôt ou point de départ, et regroupez vos commandes par zone géographique avant de planifier. L'API retourne jusqu'à 200 adresses par page, triées par distance à vol d'oiseau, et la pagination déroule la zone entière — de quoi alimenter directement un pipeline Python sans passer par un SIG dédié. Pour ordonnancer la tournée elle-même (distances et temps de trajet routiers), enchaînez avec le calcul d'itinéraire.

Formules

Quel plan pour la recherche de proximité d'adresses ?

La recherche de proximité est accessible dès le plan Growth, aux quotas standards du plan et sans surcoût. Le plan Business enrichit chaque adresse trouvée des indicateurs INSEE Filosofi. Les plans Discovery et Starter ne l'incluent pas.

Growth

500 000 req / mois

✓ Recherche de proximité (GPS ou adresse)
✓ Position WGS84 + Lambert 93
✓ Géocodage IRIS par adresse trouvée

Créer un compte

Business

Requêtes illimitées

✓ Tout le plan Growth
✓ Grille statistique INSEE Filosofi par adresse