Finnish Address Autocomplete : installation et aide

• Suggestions pour la Finlande et Åland. Recherche Digitransit sur compte et tunnel natifs, invités inclus.
• Champs remplis ensemble. Rue et numéro, code postal à cinq chiffres et ville renvoyés.
• Lettres conservées. Cage d’escalier comme 5 A ; appartement absent à saisir à la main.
• Back-office. Aide dans Clients > Adresses et fenêtres natives d’adresse.
• Saisie quotidienne. Tactile, clavier et annonces aux lecteurs d’écran ; saisie manuelle conservée.
• Votre clé. Module gratuit, quatre interrupteurs et clé Digitransit par boutique.

• Clé d'abonnement Digitransit: La clé principale de votre abonnement Digitransit developer API (portal-api.digitransit.fi, Profile > Subscriptions).
• Suggérer des adresses pendant la saisie du client : interrupteur général, après la clé.
• 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 Gestionnaire de modules > Configurer ou l’entrée Finnish Address du menu du back-office. Une page contient Configuration, Intégrité, Licence, Mise à jour et Support. Ordre visible : clé d’abonnement Digitransit, les quatre interrupteurs ci-dessus, Enregistrer. Les quatre sont activés par défaut. La clé comporte 32 caractères hexadécimaux ; un champ vide la retire et désactive ce service sur les formulaires. Aucun sélecteur de pays. En multiboutique, choisissez une boutique autorisée ; réglages et clé sont propres à celle-ci. Suivent les notes de couverture, compte, saisie manuelle, confidentialité et CSP, puis la note des modules voisins. Textes anglais et traductions allemande, française, polonaise, italienne, espagnole et finnoise sont fournis. Pas de réglages suédois ; les requêtes utilisent lang=fi pour la Finlande (FI) et lang=sv pour Åland (AX), quelle que soit la langue de la page.

Utiliser pour ces pays appartient aux modules mondiaux. Une liste vide désigne tous les pays proposés par le formulaire ; une sélection limite ce service. Finnish Address couvre la Finlande (FI) et Åland (AX) sans sélecteur de pays. Les formulaires pour Åland (AX) reçoivent des suggestions en suédois, comme Torggatan 1, 22100 Mariehamn. Le code postal détermine le pays des adresses et des rues : 22xxx désigne Åland. Les formulaires FI et AX ne reçoivent que les résultats de leur pays ; les lignes sans code postal valide sont écartées. Fonctionne aux côtés de French Address Autocomplete, Google Address Autocomplete et Fetchify Address Autocomplete ; gardez-les tous à jour. Les destinations BAN françaises sont distinctes de la Finlande et d’Åland. Une recherche en échec ne bascule pas automatiquement vers un autre service.

Autoriser Digitransit dans une politique de sécurité du contenu

L’origine externe relevée dans le code est https://api.digitransit.fi dans connect-src. Scripts et styles viennent de la boutique ; aucun SDK, police ou carte Digitransit externe n’est chargé. Fusionnez cet exemple avec votre politique existante en gardant règles du thème, inline/nonces et autres modules. Avec French Address Autocomplete, autorisez aussi https://data.geopf.fr dans connect-src. Le lien du portail sert à la configuration et n’est pas chargé par l’autocomplétion.

script-src 'self';
style-src 'self';
connect-src 'self' https://api.digitransit.fi;

Conserver les détails d’appartement et de livraison

Pays choisi, deuxième ligne, nom, société et téléphone restent inchangés. Conservez appartement, boîte, étage et entrée sur la deuxième ligne. Un numéro d’appartement reconnu après une lettre de cage d’escalier doit correspondre au résultat ; sinon, aucune suggestion n’est proposée. Un choix de rue seule vide le code postal ; complétez numéro et code à la main. Vérifiez l’adresse avant d’enregistrer. Saisie et modification manuelles restent possibles.

Prérequis

• Plage PrestaShop générale : PS 1.6 – 9.x. Minimum déclaré exact : PrestaShop 1.6.1.0 et PHP 7.1 ou ultérieur.
• Champs natifs et présentation Bootstrap 3, 4 ou 5. La Finlande ou Åland doit être disponible ; activez les pays où vous livrez.
• Vérifiez que la Finlande ou Åland est active et disponible sur les formulaires natifs utilisés.

Utiliser pour ces pays appartient aux modules mondiaux. Une liste vide désigne tous les pays proposés par le formulaire ; une sélection limite ce service. Finnish Address couvre la Finlande (FI) et Åland (AX) sans sélecteur de pays. Les formulaires pour Åland (AX) reçoivent des suggestions en suédois, comme Torggatan 1, 22100 Mariehamn. Le code postal détermine le pays des adresses et des rues : 22xxx désigne Åland. Les formulaires FI et AX ne reçoivent que les résultats de leur pays ; les lignes sans code postal valide sont écartées. Fonctionne aux côtés de French Address Autocomplete, Google Address Autocomplete et Fetchify Address Autocomplete ; gardez-les tous à jour. Les destinations BAN françaises sont distinctes de la Finlande et d’Åland. Une recherche en échec ne bascule pas automatiquement vers un autre service.

Le filtre vérifie les numéros de maison, lettres de cage d’escalier et numéros d’appartement reconnus. Une lettre isolée après le numéro peut être lue brièvement comme cage d’escalier pendant la saisie de la ville. Un numéro d’appartement reconnu sans résultat correspondant ferme la liste. Formulaires, thèmes, routes de nouvelle commande et versions mélangées nécessitent des essais.

Les suggestions commencent après trois caractères et une pause de 300 ms. Le navigateur envoie un GET direct à https://api.digitransit.fi/geocoding/v1/autocomplete avec layers=address%2Cstreet, size=10, lang=fi pour la Finlande (FI) ou lang=sv pour Åland (AX), text et digitransit-subscription-key. L’adaptateur sépare une lettre accolée au numéro, retire les codes postaux isolés de cinq chiffres et regroupe les espaces. Le texte original continue à filtrer localement les résultats. Au plus cinq options valides et distinctes sont affichées. Les adresses priment sur les rues. Les numéros de maison, lettres de cage d’escalier et numéros d’appartement reconnus doivent correspondre au résultat. Débuts de mots et numéros partiels peuvent réduire la liste ; aucun résultat n’est garanti.

Si le service est lent, la simple ligne « Recherche des adresses… » apparaît après 600 ms. La requête abandonne après dix secondes. Vos clients peuvent poursuivre la saisie manuelle.

Champs de l’adresse choisie

Le choix conserve la rue et le numéro renvoyés, comme Mannerheimintie 10 ou Hämeenkatu 5 A. La lettre de cage d’escalier A reste présente ; une lettre accolée comme 81a est également conservée. Le code postal garde cinq chiffres, dont les zéros initiaux de 00100. La ville provient de locality, avec localadmin en repli. Sur les formulaires d’Åland, Maarianhamina devient Mariehamn. Le module ne transforme pas le nom de la ville en majuscules. Pays choisi, deuxième ligne, nom, société et téléphone restent inchangés. Conservez appartement, boîte, étage et entrée sur la deuxième ligne. Un numéro d’appartement reconnu après une lettre de cage d’escalier doit correspondre au résultat ; sinon, aucune suggestion n’est proposée. Un choix de rue seule vide le code postal ; complétez numéro et code à la main. Vérifiez l’adresse avant d’enregistrer. Saisie et modification manuelles restent possibles.

Utiliser pour ces pays appartient aux modules mondiaux. Une liste vide désigne tous les pays proposés par le formulaire ; une sélection limite ce service. Finnish Address couvre la Finlande (FI) et Åland (AX) sans sélecteur de pays. Les formulaires pour Åland (AX) reçoivent des suggestions en suédois, comme Torggatan 1, 22100 Mariehamn. Le code postal détermine le pays des adresses et des rues : 22xxx désigne Åland. Les formulaires FI et AX ne reçoivent que les résultats de leur pays ; les lignes sans code postal valide sont écartées. Fonctionne aux côtés de French Address Autocomplete, Google Address Autocomplete et Fetchify Address Autocomplete ; gardez-les tous à jour. Les destinations BAN françaises sont distinctes de la Finlande et d’Åland. Une recherche en échec ne bascule pas automatiquement vers un autre service.

Dans Clients > Adresses, votre équipe peut choisir une adresse de Finlande ou d’Åland pour remplir rue, code postal et ville après un appel client. L’interrupteur du back-office est indépendant du compte et du tunnel. Le code vise aussi les fenêtres natives d’adresse d’une nouvelle commande lorsqu’elles passent par la page des adresses clients. Routes et formulaires personnalisés nécessitent un essai. Le moteur partagé prend en charge les formulaires balisés par un module hôte tel que Checkout Revolution. Le module hôte et ce module partagent les mêmes réglages de service par boutique.

Sur téléphone, vos clients touchent un résultat sous la rue. Au clavier, les flèches naviguent, Entrée sélectionne et Échap ou Tab ferme la liste. Les lecteurs d’écran reçoivent les annonces de résultats. Le composant commun suit la présentation Bootstrap du thème. Le crédit affiché est © OpenStreetMap contributors, © Digitransit 2026. Sans résultat, la liste reste fermée ; une indisponibilité est annoncée. La saisie manuelle reste possible et l’enregistrement n’exige aucun choix. Le module ne valide pas la livrabilité lors de l’envoi.

Confidentialité et crédit des données

Le navigateur envoie texte préparé, layers=address,street, size=10, lang=fi pour la Finlande (FI) ou lang=sv pour Åland (AX) et votre clé comme paramètres d’URL à https://api.digitransit.fi. Aucun paramètre distinct pour nom, courriel, téléphone, société, deuxième ligne ou pays. Le contenu saisi dans la recherche peut être transmis. La clé est visible par visiteurs et service. Les identifiants du navigateur sont désactivés ; la connexion expose l’IP et peut transmettre des informations du navigateur (en-têtes Origin et Referer) selon sa politique. Le choix ne demande aucun détail supplémentaire. Les diagnostics omettent textes, clés, URL et réponses ; PrestaShop enregistre l’adresse. Mentionnez-le dans votre politique de confidentialité. Crédit : © OpenStreetMap contributors, © Digitransit YEAR, avec l’année du serveur.

• Couverture : la Finlande et Åland, les adresses d'OpenStreetMap servies par le géocodeur Digitransit (Fintraffic et HSL) : très bonne en ville, certaines adresses rurales manquent. Les suggestions commencent une fois la clé d'abonnement enregistrée. Exhaustivité, fraîcheur, classement et usage gratuit illimité ne sont pas promis. Le résultat enregistré Itäinen Rantakatu 2 comporte deux codes postaux : vérifiez le choix.
• Une adresse exige un code postal de cinq chiffres et une ville. Lignes incomplètes, mal formées et doublons sont écartés. Sans adresse valide ni numéro reconnu, une rue seule peut remplir rue et ville en vidant le code postal. Complétez numéro et code à la main. Aucune couverture propre aux appartements, boîtes ou lieux sans rue nommée n’est établie.
• Sans clé, aucune requête ; les autorisations peuvent échouer avec 401/403. Une réponse 429 suspend les requêtes selon Retry-After ou dix secondes. Erreurs réseau, réponse invalide et délai dépassé laissent la saisie manuelle. Aucun basculement automatique de service.
• Le filtre vérifie les numéros de maison, lettres de cage d’escalier et numéros d’appartement reconnus. Une lettre isolée après le numéro peut être lue brièvement comme cage d’escalier pendant la saisie de la ville. Un numéro d’appartement reconnu sans résultat correspondant ferme la liste. Formulaires, thèmes, routes de nouvelle commande et versions mélangées nécessitent des essais.
• Ni carte, géolocalisation, stockage de coordonnées, validation à l’envoi, choix automatique du pays ou garantie de livraison. Module gratuit avec mises à jour à vie, sans engagement de support inclus. Conditions, quotas et usage d’une clé navigateur restent à vérifier.

• Aucun résultat pour la Finlande ou Åland : sélectionnez le pays, vérifiez qu’il est actif et que les interrupteurs général et du formulaire sont activés, puis saisissez la rue complète, le numéro et la ville. Clé d'abonnement Digitransit: 32 caractères hexadécimaux; 401/403.
• Fonctionne aux côtés de French Address Autocomplete, Google Address Autocomplete et Fetchify Address Autocomplete ; gardez tous ces modules à jour.
• Rue seule ou aucun résultat : complétez numéro, code postal et ville postale à la main puis vérifiez l’adresse avant d’enregistrer.
• Service indisponible : vérifiez réseau/CSP Digitransit, patientez après une limite et continuez manuellement.
• Formulaire ou présentation personnalisés : testez le formulaire natif, clavier/téléphone et route de commande ; vérifiez les réglages de service partagés par boutique.