Swiss Address Autocomplete : installation et aide

• Suggestions de rues de Suisse et du Liechtenstein. Données officielles de bâtiments swisstopo dans les formulaires natifs de compte et de commande, invités compris.
• Champs remplis ensemble. Rue et numéro, code postal à quatre chiffres et ville de l’adresse choisie.
• Couverture fixe : Suisse et Liechtenstein. Recherche avec rue et numéro ; le texte du code postal peut aussi préciser la recherche.
• Back-office. La même aide postale pour votre équipe dans Clients > Adresses.
• Saisie au quotidien. Écran tactile, clavier et annonces pour lecteurs d’écran ; saisie manuelle conservée.
• Sans compte de service. Module gratuit, données nationales gratuites, quatre interrupteurs et aucune clé.

• Suggérer des adresses pendant la saisie du client : interrupteur général, premier champ.
• Dans le formulaire d'adresse du compte client : adresses natives du compte.
• Dans les formulaires d'adresse de la commande (clients invités et adresses de facturation séparées compris) : invités et facturation distincte inclus.
• Sur le formulaire d'adresse du back-office (adresses des clients, nouvelles commandes) : adresses clients et nouvelles commandes natives.

Ouvrez Configurer dans le Gestionnaire de modules ou l’entrée Swiss Address du menu du back-office. La page unique comporte Configuration, Intégrité, Licence, Mise à jour et Support. Les quatre interrupteurs suivent l’ordre ci-dessus, puis Enregistrer ; tous sont actifs par défaut. Aucun champ de clé, compte ou pays. En multiboutique, sélectionnez une boutique autorisée. Les notes suivantes couvrent territoire/service gratuit/code postal, saisie manuelle, confidentialité et CSP, puis les services de la famille. Les textes sont fournis en anglais, allemand, français, polonais, italien et espagnol ; cela ne décrit pas six langues de données d’adresse. La section Support ne crée aucun droit de support inclus.

geo.admin.ch sert la Suisse et le Liechtenstein lorsque le pays correspondant est choisi dans le formulaire. Les résultats correspondent au pays choisi, notamment Vaduz et Schaan pour le Liechtenstein. Avec la France, les suggestions suisses s’arrêtent ; French Address Autocomplete peut alors répondre avec BAN s’il est actif pour ce même formulaire. Les destinations de livraison de votre boutique ne changent pas.

Google Address Autocomplete ou Fetchify Address Autocomplete peuvent servir d’autres pays avec leur propre configuration. Une recherche suisse en échec ne passe pas automatiquement à un autre service.

Utiliser pour ces pays appartient aux modules mondiaux de la famille. Leur sélection limite leur propre couverture ; vide signifie tous les pays disponibles dans le formulaire. Swiss Address reste fixé à CH + LI, sans ce champ. Fonctionne aux côtés de French Address Autocomplete, Google Address Autocomplete et Fetchify Address Autocomplete ; gardez tous ces modules à jour.

Autoriser geo.admin.ch dans une politique de sécurité du contenu

Origine externe déduite du code : https://api3.geo.admin.ch dans connect-src. Aucun SDK suisse ni feuille de style externe. Fusionnez cet exemple avec votre politique actuelle en conservant les règles du thème, du code intégré, des valeurs à usage unique et des autres modules. Avec French Address Autocomplete, autorisez aussi https://data.geopf.fr dans connect-src. Fonctionne aux côtés de French Address Autocomplete, Google Address Autocomplete et Fetchify Address Autocomplete ; gardez tous ces modules à jour.

script-src 'self';
style-src 'self';
connect-src 'self' https://api3.geo.admin.ch;

Conserver les détails d’appartement et de livraison

Saisissez appartement ou étage en deuxième ligne avant de choisir. Cette ligne reste intacte. Vérifiez rue, numéro, code postal et ville avant d’enregistrer. Aucun canton n’est rempli ; complétez-le si votre formulaire l’exige. Les suggestions sont facultatives et la recherche par code postal ne constitue pas un annuaire exhaustif.

Prérequis

• Plage générale PrestaShop : PS 1.6 – 9.x. Minimum déclaré exact : PrestaShop 1.6.1.0 et PHP 7.1 ou ultérieur.
• Champs d’adresse natifs avec présentation Bootstrap 3, 4 ou 5. Le pays de destination, Suisse ou Liechtenstein, doit être disponible et actif côté boutique si vous y livrez.
• Ce module ne demande ni compte de service, ni clé, ni configuration de paiement, ni installation de données cantonales. Complétez manuellement les champs de canton obligatoires.

Fonctionne aux côtés de French Address Autocomplete, Google Address Autocomplete et Fetchify Address Autocomplete ; gardez tous ces modules à jour.

Swiss Address fonctionne seul. L’installation ne certifie pas toutes les plateformes, thèmes ou réponses du service. Fonctionne aux côtés de French Address Autocomplete, Google Address Autocomplete et Fetchify Address Autocomplete ; gardez tous ces modules à jour.

Les suggestions commencent après trois caractères et 300 ms de pause. Un GET direct du navigateur envoie searchText, type=locations, origins=address, limit=10 et sr=4326 au SearchServer geo.admin.ch. Seules les adresses numérotées lisibles avec code postal à quatre chiffres et ville sont retenues. Les doublons sont retirés ; cinq options au maximum apparaissent. La sélection utilise l’adresse déjà reçue sans nouvelle recherche.

Si un service est lent, « Recherche des adresses… » apparaît ; après dix secondes, la requête suisse s’arrête et la saisie manuelle reste possible.

Champs de l’adresse choisie

L’adaptateur retire le balisage et décode les entités prises en charge du libellé. Le texte avant le code postal/ville en gras fournit la rue et le dernier élément numéroté. Rue, espace et numéro remplissent address1 ; NNNN remplit postcode ; la ville remplit city. Aucune transformation de casse ni donnée de canton. Pays, deuxième ligne et champs personnels/société/téléphone ne sont pas remplis. Une modification du formulaire, un changement de pays, un champ absent ou une longueur maximale peuvent empêcher le remplissage.

geo.admin.ch sert la Suisse et le Liechtenstein lorsque le pays correspondant est choisi dans le formulaire. Les résultats correspondent au pays choisi, notamment Vaduz et Schaan pour le Liechtenstein. Avec la France, les suggestions suisses s’arrêtent ; French Address Autocomplete peut alors répondre avec BAN s’il est actif pour ce même formulaire. Les destinations de livraison de votre boutique ne changent pas.

Google Address Autocomplete ou Fetchify Address Autocomplete peuvent servir d’autres pays avec leur propre configuration. Une recherche suisse en échec ne passe pas automatiquement à un autre service.

Utiliser pour ces pays appartient aux modules mondiaux de la famille. Leur sélection limite leur propre couverture ; vide signifie tous les pays disponibles dans le formulaire. Swiss Address reste fixé à CH + LI, sans ce champ. Fonctionne aux côtés de French Address Autocomplete, Google Address Autocomplete et Fetchify Address Autocomplete ; gardez tous ces modules à jour.

Dans Clients > Adresses, votre équipe peut saisir une adresse de Suisse ou du Liechtenstein après une demande téléphonique. Une sélection remplit les champs natifs de rue, code postal et ville. L’interrupteur du back-office est indépendant de ceux du compte et de la commande, avec l’interrupteur général.

Le code vise aussi les fenêtres d’adresse natives des nouvelles commandes servies par AdminAddresses. Les routes et formulaires personnalisés nécessitent des vérifications. Lorsque Checkout Revolution utilise ce moteur d’adresses partagé, il utilise les mêmes réglages par boutique pour ce service.

Sur téléphone, vos clients touchent un résultat sous la rue. Au clavier, utilisez les flèches et Entrée ; Échap ou Tab ferme la liste. Les lecteurs d’écran reçoivent des annonces de résultats. La liste partagée suit la présentation Bootstrap du thème.

La liste affiche la mention © swisstopo. Sans résultat, elle reste fermée ; un échec du service annonce l’indisponibilité des suggestions. La saisie et les corrections manuelles restent possibles. Aucun choix n’est imposé pour enregistrer et aucune validation de livraison n’est effectuée à l’envoi.

Confidentialité et crédit des données

Tout texte saisi dans la recherche est transmis comme searchText, y compris un code postal ou des informations personnelles entrées dans ce champ. Aucun paramètre distinct pour nom, e-mail, téléphone, société, deuxième ligne, langue ou pays choisi. Les identifiants sont désactivés et le délai est de dix secondes. La connexion directe révèle l’IP et peut transmettre des informations du navigateur (en-têtes Origin et Referer) selon les règles du navigateur. Le module ne conserve pas d’historique de recherche et n’utilise pas de relais côté boutique ; les diagnostics omettent textes et réponses. Les adresses choisies sont enregistrées normalement dans PrestaShop. Mention visible : © swisstopo. Expliquez le transfert dans votre politique de confidentialité.

• Couverture, classement et disponibilité dépendent de geo.admin.ch ; ni chaque adresse ni un service permanent ne sont garantis. Le code postal ne promet ni résultats exhaustifs ni usage illimité.
• Seules les adresses numérotées lisibles avec code postal à quatre chiffres et ville deviennent des choix. Complétez les cantons et autres détails requis.
• Les réponses 429 suspendent les requêtes selon Retry-After ou dix secondes. Délai dépassé, erreur réseau ou réponse invalide laissent la saisie manuelle ; pas de bascule automatique.
• Formulaires/thèmes personnalisés et fenêtres de nouvelles commandes routées autrement nécessitent des tests. Lorsque Checkout Revolution utilise ce moteur d’adresses partagé, il utilise les mêmes réglages par boutique pour ce service.
• Pas de carte, géolocalisation, stockage de coordonnées, validation à l’envoi, choix automatique de pays ou garantie de livraison. Module gratuit, mises à jour à vie, sans engagement de support inclus.

• Aucun résultat en Suisse ou au Liechtenstein : choisissez le pays de destination, vérifiez son activation et les interrupteurs général/formulaire, puis essayez rue complète + numéro + ville ou code postal.
• Fonctionne aux côtés de French Address Autocomplete, Google Address Autocomplete et Fetchify Address Autocomplete ; gardez tous ces modules à jour.
• Champs inattendus ou manquants : vérifiez l’adresse numérotée choisie et complétez manuellement le canton ou les autres détails requis.
• Suggestions indisponibles : examinez réseau/CSP pour api3.geo.admin.ch, attendez après une limite et poursuivez manuellement.
• Formulaire personnalisé ou souci de mise en page : testez un formulaire natif, téléphone/clavier et route de nouvelle commande ; vérifiez les réglages du service partagés par boutique.