///entrée.camion.bleueprès de Lyon · 0,4 km du focus
aperçu
API
Intégrateur API what3words : rendre une position terrain exploitable
what3words associe chaque carré de 3 mètres sur 3 à une adresse de trois mots. Dawap l’intègre sans la confondre avec une adresse postale, un itinéraire ou une preuve d’accès : saisie guidée, suggestion confirmée, conversion WGS-84, contexte de livraison, erreurs, offre API et reprise restent explicites.
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
what3words doit préciser le terrain sans remplacer l’adresse ni l’accès.
Dawap relie AutoSuggest et les conversions au checkout, au TMS ou au mobile terrain. Trois mots, carré, coordonnées, langue, choix et adresse classique restent associés. Le point ne prouve ni l’entrée accessible ni l’intention. Aucun cas client what3words nommé n’est publié à ce jour.
- Utiliser le clipping pour exclure une zone et le focus seulement pour pondérer les suggestions proches.
- Faire confirmer le résultat avec nearestPlace, carte, adresse ou consigne avant de modifier une commande ou une intervention.
- Séparer BadWords, clé invalide, fonction non incluse ou quota dépassé, throttling et indisponibilité technique.
Le carré n’est pas la consigne
La précision vaut seulement si le terrain la confirme.
Le parcours montre les suggestions, le carré et l’accès avant d’écrire quoi que ce soit dans la commande. Trois mots complètent l’adresse postale et la consigne ; ils ne les effacent jamais.
Simulation AutoSuggestConfirmer l’entrée livraison
choix requis
Adresse trois mots
///entrée.camion.bleue
exemple de parcours · langue fr
///entrée.camions.bleueautre carré · 4,8 km du focus
écarter///entrées.camion.bleuhors zone de livraison
clippé
clip-to-countryFR
focusGPS du site
nearestPlaceLyon
Aperçu du dernier mètreLe carré et son accès
simulation · 3 m × 3 m
Portail B
3 × 3 m
Accès à confirmerLe centre du site est derrière la clôture
Objet transmis au terrainAdresse + carré + Portail B + consigne
confirmé
400BadWordscorriger ou suggérer
401Cléalerter le run
402Plan / quotaconserver la saisie
429Débitralentir et reprendre
Quand la précision masque le contexte
Trois raccourcis transforment un carré précis en mauvaise décision.
La conversion peut être exacte alors que la suggestion sort du périmètre, que le carré vise le mauvais côté de la clôture ou qu’une erreur de plan est affichée comme une position invalide.
01
Focus & clipping
La proximité est traitée comme une exclusion géographique
Le focus classe ; seul le clipping borne réellement le pays, le cercle, la bounding box ou le polygone.
02
Carré & accès
Le bon carré désigne le mauvais point d’entrée
Adresse, carte, consigne, contact et confirmation terrain doivent compléter la précision 3 m × 3 m.
03
Plan & quota
Une erreur 402 ou 429 devient « adresse inconnue »
Fonction non incluse, quota et débit doivent déclencher un message et un fallback différents d’un BadWords.
Architecture what3words
Trois mots peuvent désigner le bon carré et pourtant envoyer l’équipe au mauvais accès
L’API code et décode une position. Le SI doit encore relier cette position à l’objet métier, présenter une suggestion compréhensible, conserver le contexte et décider ce qui se passe si le service ou l’utilisateur ne confirme pas.
AutoSuggest
Déclencher après deux mots et la première lettre du troisième, afficher peu de suggestions avec nearestPlace, puis enregistrer celle qui a été confirmée.
Clipping et focus
Restreindre avec country, circle, bounding box ou polygon ; utiliser focus pour classer les candidats, jamais pour les exclure.
Deux conversions
Convertir coordonnées vers adresse trois mots ou trois mots vers coordonnées, avec carré, pays, langue, locale et format JSON ou GeoJSON.
Dernier mètre
Conserver adresse postale, entrée, consigne, contact, photo ou géométrie utile : le carré seul ne décrit pas l’accès praticable.
Clé et offre
Passer la clé par contrat contrôlé, vérifier les fonctions incluses et le quota de conversion ; le plan gratuit ne couvre actuellement que AutoSuggest et les langues.
Erreurs et continuité
Traiter BadWords, BadCoordinates, 401, 402, 429 et 50x selon leur cause, sans transformer une panne ou une limite en position invalide.
Méthode
On part des lieux où vos équipes appellent déjà le client
Le bon pilote ne couvre pas tous les formulaires. Il prend un parcours qui échoue, rejoue ses lieux difficiles et mesure si la confirmation what3words réduit réellement les corrections sans supprimer les preuves dont le terrain a besoin.
Choisir le cas terrain
Livraison, intervention ou collecte avec les lieux qui génèrent déjà des corrections.
Borner la saisie
Langue, clipping, focus, trois suggestions et contexte nearestPlace visible.
Confirmer le point
Carré, carte, adresse, accès, consigne et utilisateur qui valide la destination.
Exercer le fallback
BadWords, clé, plan, quota, débit, indisponibilité et reprise sans perdre la saisie.
Premier lot what3words
Prouver que trois mots réduisent un échec terrain réel.
Nous choisissons un parcours difficile et un échantillon de lieux problématiques, puis mesurons suggestions, confirmations, corrections et fallbacks avant toute extension.
1 parcours difficile
1 confirmation visible
1 fallback testé
Décisions de sortie
Parcours & preuve Pays, canal, source du point, précision, consommateur et criticité.
Jeu terrain Fautes, mots proches, langue, frontière, GPS imprécis et accès distincts.
Confirmation UX Clipping, focus, nearestPlace, carte, adresse et choix explicite.
Erreur & reprise Mots, carré, coordonnées, consigne, 400/401/402/429, fallback et owner.
Recette what3words
Trois contre-tests qui évitent une fausse précision terrain
La recette ne vérifie pas seulement qu’une conversion répond 200. Elle provoque les confusions propres à what3words : classement pris pour restriction, carré pris pour accès et incident de plan pris pour adresse invalide.
Le focus classe un candidat proche sans exclure le mauvais pays
Un utilisateur saisit deux mots et une lettre. AutoSuggest renvoie des adresses valides et focus privilégie la proximité ; sans clipping, un candidat hors périmètre peut rester dans la liste et le rang ne prouve pas l’intention.
- Entrée
- Saisie brute, langue, pays attendu, focus, clip-to-country/circle/bounding-box/polygon, rang, distanceToFocusKm, nearestPlace et confirmation.
- Sortie
- Règle UX qui sépare restriction géographique, classement, nombre de suggestions, affichage du contexte et validation humaine.
- Décision
- Clipper quand le périmètre est connu ; ne jamais enregistrer silencieusement la première suggestion.
Un carré de 3 mètres sur 3 tombe derrière une clôture ou sur un accès fermé
convert-to-3wa encode correctement le point GPS, mais la capture provenait du centre du site et non de l’entrée utilisable. Les trois mots sont exacts pour ce carré ; ils ne valident ni la qualité du GPS, ni l’accessibilité, ni la consigne métier.
- Entrée
- Coordonnée source, précision du terminal, square southwest/northeast, carte, entrée attendue, sens de circulation, créneau, contact et fallback adresse.
- Sortie
- Objet de localisation qui conserve source, précision, mots, carré, adresse postale, accès, consigne, confirmation et date.
- Décision
- Faire confirmer le point d’accès et garder les informations opérationnelles ; ne pas présenter les mots comme une garantie de livraison.
Une conversion répond 402 et le checkout affiche « adresse inconnue »
Le plan gratuit donne actuellement accès à AutoSuggest et available-languages, pas aux conversions. Une fonction non incluse ou un quota convert-to-coordinates dépassé peut répondre 402 ; un débit trop élevé répond 429. Aucun de ces cas ne rend les trois mots invalides.
- Entrée
- Plan actif, endpoint, quota de période, rate limit, clé, HTTP status, error.code, volume par canal, retry et comportement utilisateur.
- Sortie
- Matrice d’erreurs distinguant 400 de saisie, 401 de clé, 402 de plan/quota, 429 de débit, 50x de service et fallback métier.
- Décision
- Ne jamais corriger les mots à cause d’un incident d’offre ; préserver la saisie et basculer vers confirmation manuelle ou coordonnées déjà connues.
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 what3words
5/5★★★★★Avis clients Dawap
“
Saisie, candidats, zone, rang, nearestPlace, aperçu et confirmation restent relisibles.
“
Carré, GPS, adresse, accès et consigne gardent chacun leur responsabilité.
“
Clé, plan, quota, débit, erreur, fallback et reprise sont suivis par parcours.
what3words convertit coordonnées et adresses 3 mots, corrige les saisies avec AutoSuggest et expose grille, langues, quotas et erreurs. La méthode cadre API key, 402, 429, focus, clipping, carré, pays, nearestPlace, cache, proxy, support, retour arrière, monitoring et intégration CRM, OMS, TMS ou application terrain.
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 what3words API
Questions fréquentes sur l’API what3words, AutoSuggest, clipping, focus, conversions, carrés de 3 mètres, clés, plans, quotas, erreurs et fallback.
01what3words remplace-t-il une adresse postale ?
Non. Une adresse what3words identifie un carré précis. Pour une livraison ou une intervention, on conserve aussi l’adresse postale, l’accès, la consigne, le contact et les validations exigées par le transporteur ou le métier.
02Quelle différence entre focus et clipping dans AutoSuggest ?
focus pondère les suggestions pour favoriser celles proches d’une coordonnée. Le clipping restreint réellement les candidats à un pays, un cercle, une bounding box ou un polygone. Le rang reste à confirmer par l’utilisateur.
03Que faut-il stocker après une conversion what3words ?
Les trois mots, la langue et locale, le pays, nearestPlace, les coordonnées, les bornes du carré, la saisie ou coordonnée source, l’objet métier, la confirmation et la date. La clé API n’entre jamais dans cette preuve.
04Le plan gratuit permet-il convert-to-coordinates ?
La documentation officielle indique actuellement que le plan gratuit couvre AutoSuggest et available-languages. Les conversions exigent une offre adaptée ; une fonction absente ou un quota convert-to-coordinates dépassé peut répondre HTTP 402.
05Comment traiter BadWords et HTTP 429 ?
BadWords signale une adresse trois mots invalide et demande une correction ou AutoSuggest. HTTP 429 signifie que le débit est trop élevé : on applique limitation, retry contrôlé et mode dégradé sans déclarer la position invalide.
06Quel premier lot what3words recommandez-vous ?
Un seul parcours avec des lieux réellement difficiles, AutoSuggest borné, confirmation visuelle, conversions, adresse et consigne conservées, erreurs distinctes et mesure des corrections avant/après.
Intégration d’une localisation en trois mots
Vous voulez préciser le terrain sans perdre l’adresse ni le contexte ?
On peut cadrer un parcours what3words, livrer une première intégration et rendre chaque suggestion, conversion, erreur et reprise vérifiable.
Cadrer mon intégration what3words