une adresse de livraison choisie dans une suggestion est enregistrée sous une forme structurée, et non en texte libre.
Une adresse correcte avant qu'elle n'entre dans vos systèmes
Lors d'une commande en ligne, d'une création de compte ou d'une réservation, vos utilisateurs ne saisissent pas toujours une adresse complète. Woosmap leur propose les résultats pertinents dès les premiers caractères, puis transmet à votre application une adresse structurée et prête à être utilisée.
L'API Localities s'intègre à un formulaire, à un champ de recherche ou à une carte, sur le web comme dans une application mobile.
Quand une adresse incomplète se propage dans vos systèmes
Un utilisateur qui remplit une adresse veut finir son parcours. Il lui arrive d'abréger, d'oublier une apostrophe, de s'arrêter au milieu du nom de la voie, de ne se souvenir que du début du code postal. Un champ de texte libre accepte tout cela sans rien signaler.
Votre système reçoit alors une saisie non structurée. Elle peut être incomplète, ambiguë, ou simplement difficile à exploiter telle quelle : avant qu'une livraison, un contrôle d'éligibilité ou une fiche client s'en serve, il faut souvent la compléter, la corriger ou la répartir en voie, ville, code postal et coordonnées. Ce traitement arrive alors après coup, alors qu'une adresse choisie au moment de la saisie aurait évité la correction.
Du premier caractère à l'adresse enregistrée
Quatre temps, du champ de saisie jusqu'à votre base.
L'utilisateur commence à saisir
Il tape les premiers caractères dans votre champ d'adresse, comme dans n'importe quel formulaire. Il reste dans ce même champ, sans avoir à renseigner séparément la voie, la ville et le code postal.
/autocomplete
Woosmap propose les adresses qui correspondent
Autocomplete renvoie jusqu'à 5 suggestions pour le texte saisi, triées par pertinence. La correspondance porte sur les mots entiers comme sur des fragments, et les abréviations courantes et les apostrophes sont reconnues : des suggestions pertinentes apparaissent avant même qu'il ait fini d'écrire.
L'utilisateur choisit la bonne adresse
Il sélectionne une suggestion dans la liste. C'est ce geste, et non la frappe, qui détermine l'adresse retenue.
/details
Votre application reçoit l'adresse complète
Details renvoie l'adresse formatée, ses composants structurés et les coordonnées avec leur niveau de précision. Votre formulaire les répartit dans ses champs en une seule action, et votre système métier reçoit une donnée exploitable plutôt qu'un texte à reprendre.
Trois parcours où une adresse fiable est décisive
Trois parcours dont la suite dépend de la qualité de l'adresse enregistrée.
Ce que Woosmap apporte à ce parcours
- Des suggestions pertinentes dès les premiers caractères
La recherche porte sur les adresses, les villes, les codes postaux, les aéroports et d'autres types de lieux. Vous pouvez la restreindre aux pays où vous opérez.
- Une adresse complète, et ses composants séparés
Details renvoie l'adresse formatée, ses composants structurés et les coordonnées avec leur niveau de précision. Cette précision se décline en quatre niveaux, du toit du bâtiment à la ville, et la documentation détaille le niveau disponible pays par pays.
- Des données adaptées au marché français
Pour la France, Woosmap s'appuie sur la base nationale d'adresses : 25 millions d'adresses et 250 000 localités couvrant l'ensemble des communes. La recherche de code postal y porte sur 5 chiffres.
Réduire les erreurs de saisie et les corrections manuelles
Avec Woosmap, les erreurs de saisie d'adresse des clients diminuent : celles qui demanderaient de longues corrections manuelles, ou qui se termineraient en expéditions coûteuses.
Avis publié sur Capterra
Ils font confiance à Woosmap
Pour votre équipe technique
Deux appels suffisent à câbler le parcours décrit plus haut.
- Les deux appels, dans cet ordre
GET https://api.woosmap.com/localities/autocomplete/propose, etGET https://api.woosmap.com/localities/detailscomplète. Les réponses Autocomplete servent à l'affichage des suggestions : l'appel à Details est requis avant de stocker, de traiter ou d'afficher un lieu comme résultat final.- Les clés, selon l'endroit d'où vous appelez
Côté navigateur, la requête emploie une clé publique
key, qui exige une restriction de domaine ou d'IP. Côté serveur, elle emploie une clé privéeprivate_key, ou l'en-têteX-Api-Key.- Le paramètre qu'on oublie
Les adresses ne figurent pas dans les résultats par défaut : il faut passer
types=addresspour les autocompléter.components=country:restreint la recherche aux pays que vous indiquez.- Le debounce de la saisie
Pour garder la maîtrise des appels et adapter le comportement à la vitesse de frappe de vos utilisateurs, appliquez un debounce au champ de saisie.
GET https://api.woosmap.com/localities/autocomplete/?input=rue+de+la+paix&types=address&components=country:fr&key=YOUR_API_KEY
GET https://api.woosmap.com/localities/details?public_id=PUBLIC_ID_FROM_STEP_1&key=YOUR_API_KEYRelevez un public_id dans la réponse de la première requête, reportez-le dans la seconde : vous obtenez la liste des suggestions, puis l'adresse complète avec ses address_components et sa geometry.
Essayer le sample Autocomplete · Choisir sa voie d'intégration · Référence d'API Details · Géocoder des adresses par lots
Testez gratuitement, passez à l'échelle simplement
Plan Free
De quoi câbler le parcours et le tester, sans carte bancaire.
- 10 000 requêtes API gratuites par mois
- Localities inclus
- Les requêtes Autocomplete sont comptées dans cette enveloppe
EN PRODUCTION
Offres Pro et Enterprise
Ce qui change une fois le parcours en ligne.
- Les requêtes Autocomplete ne sont pas facturées
- 5 000 requêtes Details incluses chaque mois
- Au-delà, Details suit la tarification qui lui est applicable
Une réponse Autocomplete sert à l'affichage : c'est l'appel Details qui renvoie l'adresse que vous enregistrez.
Certaines données d'adresses nationales premium demandent une activation produit, disponible sur les offres Pro et Enterprise. Les montants et les paliers détaillés sont sur la page tarifs : tarifs Autocomplete · tarifs Details
Les questions qui reviennent
Woosmap ne conserve pas les adresses saisies ni les suggestions choisies après avoir répondu à la requête. Notre avenant au traitement des données en porte les termes contractuels.
Non. La base d'adresses de Localities n'est pas reliée à des noms, prénoms ou numéros de téléphone : on ne peut donc pas y retrouver une adresse à partir d'une personne.
Le produit actuel est l'API Localities. L'Address API est en cours de dépréciation pour tous les abonnements : Localities bénéficie des données à jour, du support et des améliorations apportées à la recherche d'adresse.
Oui, la documentation Localities en publie un : guide de migration.
Le SLA à 99,9 % relève de l'offre Enterprise. La page tarifs détaille ce que porte chaque offre.
Oui. Woosmap s'achète aussi via AWS Marketplace : l'abonnement est consolidé sur votre facture AWS existante.
Prochaine étape
Localities est inclus dans le plan Free, et aucune carte bancaire n'est requise pour démarrer. Si votre périmètre demande davantage, notre équipe en discute avec vous.