OpenStreetMaplieux & voirie
public
API
Intégrateur Pelias API : un géocodeur ouvert relié à vos décisions métier
Pelias réunit recherche d’adresses, autocomplete, reverse geocoding et données géographiques ouvertes dans une architecture modulaire. Dawap intègre un service Pelias hébergé ou construit votre instance avec ses sources, son index Elasticsearch, ses services auxiliaires, ses règles d’acceptation et son exploitation.
APIs, données et infrastructures que nos projets savent connecter
Du besoin métier au run mesurable
01
Contrat
versionné
02
Sécurité
explicite
03
Reprise
testée
04
Supervision
actionnable
Réponse immédiate
Pelias doit relier chaque résultat à sa source et à son index.
Dawap relie Search, Autocomplete, Reverse et vos sources à une identité métier stable. Pelias est le logiciel open source ; un service hébergé comme Geocode Earth reste une offre distincte. Aucun cas client Pelias nommé n’est publié à ce jour.
- Choisir service hébergé ou instance propre selon couverture, sources, volume, données privées et responsabilité de run.
- Qualifier chaque résultat par source, layer, match_type, accuracy et composants d’adresse avant décision.
- Ne jamais utiliser un gid Pelias comme identifiant métier durable entre deux reconstructions d’index.
La qualité se construit à l’import
Un résultat Pelias doit raconter son index.
Le studio de recette compare l’index actif et son candidat sur un jeu de vérité. Une adresse n’est promue que si sa provenance, sa précision et son identité restent compréhensibles après reconstruction.
Simulation de rebuildIndex France · adresses métier
candidate r119
OpenAddressespoints adresse
publicWho’s on Firsthiérarchies
publicRéférentiel privésites clients
interne- 01ImportersSources normaliséesok
licence · provenance · source_id
- 02Serviceslibpostal · Placeholder · PIPok
fonctions activées et versionnées
- 03Elasticsearchpelias-fr-r119ready
mapping · documents · analyseurs
Result inspectorAdresse candidate
test · addr_042
/v1/search
12 rue des Acacias, Lyon
boundary.country=FRA · layers=address
Feature retenue12 Rue des Acacias · 69003 Lyonrang 01
- source
- openaddresses
- layer
- address
- match_type
- exact
- accuracy
- point
- confidence
- 0.88
- build
- r119
Décision de recetteAccepter le résultat, pas son gid comme vérité durable.Les composants utiles et la version d’index accompagnent le verdict.
Quand le résultat dépend de l’index
Trois dérives rendent un géocodeur Pelias instable.
Une recherche peut sembler pertinente alors que la réponse obsolète gagne la course, qu’un score masque un fallback ou qu’un rebuild rompt les identifiants conservés par le métier.
01
Autocomplete
Une réponse obsolète remplace la requête la plus précise
Debounce, annulation, ordre réseau et sélection doivent empêcher une ancienne suggestion d’écraser le parcours courant.
02
Qualité
Confidence devient un seuil universel d’acceptation
Source, layer, match_type, accuracy et composants attendus doivent compléter le score pour chaque usage.
03
Identité
Le gid Pelias devient la clé durable du dossier
L’identité métier doit survivre aux nouvelles sources, imports, rebuilds et changements de gid.
Architecture Pelias
Le logiciel Pelias, son endpoint et vos données ne forment pas un service par magie
Pelias fournit une API de géocodage modulaire. Un service exploitable exige encore un choix d’hébergement, un assemblage de sources, des composants auxiliaires, des règles de qualité et une identité métier qui survive aux changements de l’index.
Search et structured
Utiliser /v1/search pour le texte libre et /v1/search/structured — annoncé en beta — lorsque les composants adresse, localité, région ou code postal sont déjà séparés.
Autocomplete
Throttler les appels, annuler les réponses dépassées et valider la sélection sans confondre suggestion rapide et adresse acceptée par le métier.
Reverse et place
Partir de point.lat et point.lon pour le reverse ; réserver /v1/place aux gid renvoyés par Pelias, sans en faire des clés durables.
Sources, layers et zones
Distinguer la provenance du document, son type, un focus qui favorise la proximité et une boundary qui restreint réellement la recherche.
Index et services
Assembler Elasticsearch, API, Placeholder, libpostal, PIP et, si utile, interpolation ; versionner chaque configuration et reconstruction.
Données et licences
Gouverner OpenStreetMap, OpenAddresses, Who’s on First, GeoNames, polylines, CSV ou données privées avec attribution et droits propres à chaque source.
Méthode
On choisit les données et les critères d’acceptation avant de dimensionner le cluster
Une instance mondiale et un référentiel territorial n’ont ni le même index ni le même run. Le périmètre part des requêtes réelles, des sources autorisées et du verdict attendu ; l’infrastructure suit les imports, la charge et le niveau de disponibilité mesurés.
Nommer le verdict
Suggestion à afficher, adresse à accepter, position à rattacher ou donnée à refuser.
Composer l’index
Sources, layers, licences, priorités, importers et services nécessaires au territoire.
Stabiliser l’identité
Clé métier, snapshot utile, gid courant, source_id et version de build séparés.
Recetter la bascule
Jeu de vérité, comparaison candidate, alias, rollback et surveillance après rebuild.
Premier lot Pelias
Éprouver un parcours Pelias et sa reconstruction d’index.
Nous choisissons une décision — saisie, géocodage ou reverse — puis la rejouons sur vos cas ambigus avant et après un nouvel import pour vérifier qualité et continuité.
1 jeu de vérité
2 index comparés
1 identité stable
Décisions de sortie
Parcours & verdict Endpoint, source, layer, composants requis et propriétaire de la décision.
Jeu de vérité Adresses exactes, ambiguës, absentes, interpolées et hors périmètre.
Index & données Hébergement, sources, licences, importers, services et cadence de rebuild.
Bascule & run Comparaison qualité, identité interne, rollback, métriques et runbook.
Recette Pelias
Trois contre-tests propres à Pelias
La recette cible les erreurs qui passent facilement en démonstration : une réponse autocomplete arrivée trop tard, un fallback pris pour une adresse exacte et un gid conservé comme clé après reconstruction.
La réponse de la requête courte arrive après la requête précise
L’utilisateur saisit plusieurs caractères rapidement. Une ancienne réponse réseau revient en dernier et remplace les suggestions récentes ; un focus de proximité est aussi traité comme une frontière dure alors qu’il ne fait que favoriser des résultats.
- Entrée
- Séquence, identifiant de requête, debounce, annulation, focus.point, boundary, sources, layers, sélection et validation finale.
- Sortie
- Composant autocomplete qui ignore les réponses obsolètes, différencie biais et restriction et confirme la valeur sélectionnée.
- Décision
- Ne jamais écrire une adresse métier depuis une suggestion dépassée ou depuis un focus interprété comme une exclusion.
Un résultat de confiance élevée reste un fallback ou un centroid
Pelias peut renvoyer exact, interpolated ou fallback et une accuracy point ou centroid. Confidence agrège plusieurs signaux, mais l’ordre des résultats ne suit pas nécessairement ce score ; aucun seuil universel ne prouve que l’adresse répond au cas métier.
- Entrée
- Requête initiale, composants attendus, match_type, accuracy, confidence, layer, source, distance éventuelle et champs non concordants.
- Sortie
- Règles d’acceptation par parcours avec résultat exact, interpolation autorisée, fallback refusé, revue manuelle et message utilisateur.
- Décision
- Refuser ou faire valider le résultat dès que type, précision ou composants indispensables ne satisfont pas le contrat.
Un gid Pelias expiré ne doit pas casser un dossier historique
Après mise à jour des sources ou rebuild, un gid peut changer ou ne plus être résolu par /v1/place. La documentation le réserve à l’identification d’un résultat au moment de la requête, pas à une clé métier pérenne.
- Entrée
- Usage actuel du gid, source_id, identifiant interne, adresse normalisée, coordonnées, version d’index, cadence de rebuild et procédure de rapprochement.
- Sortie
- Identité interne indépendante, snapshot des champs utiles, version de l’index et stratégie de réconciliation après import.
- Décision
- Utiliser /v1/place dans le parcours courant ; ne jamais faire dépendre la continuité d’un dossier du seul gid Pelias.
Maillage API
Poursuivre dans le bon univers API
Ces liens permettent de repartir vers la page principale ou vers les univers proches quand le besoin dépasse le seul connecteur.
Avis & exigence projet
Ce que l’on sécurise avec Pelias
5/5★★★★★Avis clients Dawap
“
Requête, paramètres, source, layer, qualité, résultat retenu et règle métier restent reliés.
“
Le dossier possède sa propre clé et ne dépend pas d’un gid susceptible de changer après rebuild.
“
Imports, index, services, licences, latence, zéro résultat, régressions et bascule sont observés.
Attractivité-locale.fr transforme un portail de collectivité en point d’entrée vers les entreprises, leurs offres d’emploi et leur carte OpenStreetMap. Dawap a relié le référentiel géographique de l’État, un back-office multi-rôles et treize routes API de lecture, sans confondre données territoriales et données d’entreprise.
Pelias est un géocodeur open source pour search, autocomplete, reverse, structured et place, mais sa valeur dépend du modèle GeoJSON, des sources, layers, gid, index Elasticsearch, cache et preuves de run. La méthode cadre proxy, throttling, rebuild, licences data, instance dédiée, support, retour arrière et trajectoire de production.
Une API cartographie et géoloc fiable doit arbitrer entre géocodage, ETA, cache, quotas et fallback, sinon la promesse client se dégrade vite. Cette synthèse met l'accent sur le vrai point de contrôle : garder la précision, la source et le coût sous surveillance avant de promettre un itinéraire ou une zone pour chaque flux.
Questions d’achat
Questions fréquentes sur l’intégration Pelias API
Questions fréquentes sur Pelias API, search, autocomplete, reverse geocoding, sources, qualité, gid, service hébergé et instance auto-hébergée.
01Pelias fournit-il une API publique prête à utiliser ?
Pelias est un logiciel open source sans système de clé intégré. Vous pouvez l’auto-héberger ou choisir un service hébergé fondé sur Pelias, comme Geocode Earth, avec son propre contrat, ses limites et son exploitation.
02Quels endpoints Pelias faut-il intégrer ?
/v1/search traite le texte libre, /v1/autocomplete les suggestions, /v1/reverse une coordonnée, /v1/place un gid récent et /v1/search/structured des composants déjà séparés. Ce dernier est documenté comme beta.
03Peut-on mélanger OpenStreetMap et des données privées ?
Oui. Pelias fournit des importers pour plusieurs sources ouvertes et permet des imports CSV ou spécifiques. Il faut gérer doublons, provenance, priorité, fraîcheur, licences et attribution par source.
04Le champ confidence suffit-il pour accepter une adresse ?
Non. Il faut aussi contrôler match_type, accuracy, layer, source et composants concordants. La documentation précise que les résultats ne sont pas toujours triés par confidence et qu’un fallback voit sa confiance réduite.
05Peut-on conserver le gid Pelias comme identifiant métier ?
Non. Un gid identifie utilement un résultat courant et peut alimenter /v1/place, mais il peut changer ou expirer avec les sources et les builds. Le dossier doit garder une identité interne et les champs nécessaires à son audit.
06Que faut-il exploiter dans une instance Pelias privée ?
Au minimum l’API et Elasticsearch, puis les importers et services requis par les fonctions choisies : Placeholder et libpostal pour la recherche, PIP pour le reverse administratif, interpolation si elle est autorisée. Il faut aussi reconstruire, tester, superviser et attribuer les données.
Intégration d’un géocodeur open source maîtrisé
Vous voulez intégrer Pelias sans transformer un score en vérité métier ?
On peut cadrer le service hébergé ou votre instance, livrer un premier parcours de géocodage et rendre sources, qualité, identité et run vérifiables.
Cadrer mon intégration Pelias