Finnish Address Autocomplete

Finnish Address Autocomplete è un modulo PrestaShop gratuito per inserire indirizzi in Finlandia e nelle Åland. Un indirizzo Digitransit scelto compila via e numero civico, CAP di cinque cifre e città. Digitransit è il geocoder di Fintraffic e HSL che usa indirizzi OpenStreetMap. Per avviare i suggerimenti ti servono il tuo account e la tua chiave gratuita di sottoscrizione Digitransit. I moduli per le Åland (AX) ricevono suggerimenti in svedese, come Torggatan 1, 22100 Mariehamn.

Avvio rapido

1. Carica e installa lo ZIP del modulo. Registrati gratuitamente su portal-api.digitransit.fi e sottoscrivi Digitransit developer API.
2. Copia la chiave primaria da Profile > Subscriptions. Apri Configura o la voce Finnish Address nel menu del back office; in multinegozio scegli un negozio che puoi gestire.
3. Verifica che la Finlandia o le Åland siano attive e disponibili sui moduli nativi di indirizzo utilizzati.
4. Incolla prima la tua chiave Digitransit. Imposta gli interruttori generale, account, checkout e back office, poi salva. Nessun selettore di paesi.
5. Funziona accanto a French Address Autocomplete, Google Address Autocomplete e Fetchify Address Autocomplete; mantienili tutti aggiornati.
6. Aggiungi https://api.digitransit.fi alla CSP esistente e cita connessione e chiave nella privacy. Controlla condizioni e quote.
7. Scegli Finlandia e scrivi mannerheimintie 10 helsinki. Se restituito, scegli Mannerheimintie 10 e controlla 00100 Helsinki. Scegli anche Åland (AX) e prova torggatan 1 mariehamn per i suggerimenti in svedese. Prova lettere di scala, sola via, inserimento manuale, ospiti, fatture, operatori/nuovo ordine, Francia con French Address Autocomplete e telefono.

Funzionalità

• Suggerimenti per Finlandia e Åland. Ricerca Digitransit nei moduli nativi di account e checkout, ospiti inclusi.
• Campi insieme. Via e civico, CAP di cinque cifre e città dal risultato.
• Lettere conservate. Scala come 5 A mantenuta; interni assenti da inserire a mano.
• Back office. Aiuto in Clienti > Indirizzi e finestre native di indirizzo.
• Uso quotidiano. Tocco, tastiera e lettori di schermo; inserimento manuale disponibile.
• La tua chiave. Modulo gratuito, quattro interruttori e chiave Digitransit per negozio.

Opzioni di configurazione

• Chiave di sottoscrizione Digitransit: La chiave primaria della tua sottoscrizione Digitransit developer API (portal-api.digitransit.fi, Profile > Subscriptions).
• Suggerisci indirizzi mentre il cliente scrive: interruttore generale, dopo la chiave.
• Nel modulo indirizzo dell'account cliente: indirizzi nativi dell’account.
• Nei moduli indirizzo del checkout (inclusi ospiti e indirizzi di fatturazione separati): ospiti e fatturazione separata inclusi.
• Nel modulo indirizzo del back office (indirizzi dei clienti, nuovi ordini): indirizzi clienti e nuovi ordini nativi.

Apri Gestione moduli > Configura o la voce Finnish Address nel menu del back office. Una pagina contiene Configurazione, Integrità, Licenza, Aggiornamento e Supporto. Ordine visibile: chiave Digitransit, i quattro interruttori sopra, Salva. Sono tutti attivi per impostazione iniziale. La chiave ha 32 caratteri esadecimali; vuota la rimuove e disattiva il servizio sui moduli. Non c’è selettore di paesi. In multinegozio scegli un negozio che puoi gestire; chiave e impostazioni sono per negozio. Seguono note su copertura, account, inserimento manuale, privacy e CSP, poi quella dei moduli correlati. Sono forniti testo inglese e traduzioni tedesca, francese, polacca, italiana, spagnola e finlandese. Nessuna impostazione svedese; le richieste usano lang=fi per la Finlandia (FI) e lang=sv per le Åland (AX), indipendentemente dalla lingua della pagina.

Usa per questi paesi appartiene ai moduli mondiali. Una lista vuota indica tutti i paesi disponibili nel modulo; una selezione limita quel servizio. Finnish Address ha copertura fissa della Finlandia (FI) e delle Åland (AX) senza selettore di paesi. I moduli per le Åland (AX) ricevono suggerimenti in svedese, come Torggatan 1, 22100 Mariehamn. Il CAP determina il paese sia degli indirizzi sia delle vie: 22xxx identifica le Åland. I moduli FI e AX ricevono solo risultati del proprio paese; le righe senza CAP valido vengono scartate. Funziona accanto a French Address Autocomplete, Google Address Autocomplete e Fetchify Address Autocomplete; mantienili tutti aggiornati. Le destinazioni BAN francesi sono separate dalla Finlandia e dalle Åland. Un errore di ricerca non passa automaticamente a un altro servizio.

Esempi di personalizzazione

Consenti Digitransit nella politica di sicurezza dei contenuti

L’origine esterna rilevata nel codice è https://api.digitransit.fi in connect-src. Script e stili arrivano dal negozio; non vengono caricati SDK, font o mappe esterni Digitransit. Unisci l’esempio alla politica esistente mantenendo regole del tema, inline/nonce e altri moduli. Con French Address Autocomplete consenti anche https://data.geopf.fr in connect-src. Il link al portale serve alla configurazione e non viene caricato dall’autocompletamento.

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

Conserva appartamento e dettagli di consegna

Paese scelto, seconda riga, nome, azienda e telefono restano invariati. Tieni appartamento, casella, piano e ingresso sulla seconda riga. Un numero di interno riconosciuto dopo una lettera di scala deve corrispondere al risultato; altrimenti non appare alcun suggerimento. Scegliere solo la via svuota il CAP; completa civico e CAP a mano. Controlla tutto l’indirizzo prima di salvare. Inserimento e modifica manuali restano possibili.

Installazione

Requisiti

• Intervallo PrestaShop generale: PS 1.6 – 9.x. Minimo esatto dichiarato: PrestaShop 1.6.1.0 e PHP da 7.1.
• Campi nativi e presentazione Bootstrap 3, 4 o 5. La Finlandia o le Åland devono essere disponibili; attiva i paesi in cui consegni.
• Verifica che la Finlandia o le Åland siano attive e disponibili nei moduli indirizzo nativi che usi.

Usa per questi paesi appartiene ai moduli mondiali. Una lista vuota indica tutti i paesi disponibili nel modulo; una selezione limita quel servizio. Finnish Address ha copertura fissa della Finlandia (FI) e delle Åland (AX) senza selettore di paesi. I moduli per le Åland (AX) ricevono suggerimenti in svedese, come Torggatan 1, 22100 Mariehamn. Il CAP determina il paese sia degli indirizzi sia delle vie: 22xxx identifica le Åland. I moduli FI e AX ricevono solo risultati del proprio paese; le righe senza CAP valido vengono scartate. Funziona accanto a French Address Autocomplete, Google Address Autocomplete e Fetchify Address Autocomplete; mantienili tutti aggiornati. Le destinazioni BAN francesi sono separate dalla Finlandia e dalle Åland. Un errore di ricerca non passa automaticamente a un altro servizio.

Il filtro verifica civico, lettera di scala e interno riconosciuti. Una lettera isolata dopo il civico può essere letta per un momento come scala mentre scrivi la città. Un interno riconosciuto senza corrispondenza nasconde la lista. Moduli, temi, percorsi di nuovo ordine e versioni miste richiedono prove.

Come funziona

I suggerimenti iniziano dopo tre caratteri e 300 ms di pausa. Il browser invia un GET diretto a https://api.digitransit.fi/geocoding/v1/autocomplete con layers=address%2Cstreet, size=10, lang=fi per la Finlandia (FI) o lang=sv per le Åland (AX), text e digitransit-subscription-key. L’adattatore separa una lettera unita al civico, rimuove CAP isolati di cinque cifre e riunisce gli spazi. La ricerca originale continua a filtrare i risultati localmente. Appaiono al massimo cinque opzioni valide e distinte. Gli indirizzi precedono le vie. Civico, lettera di scala e interno riconosciuti devono corrispondere al risultato. Inizi di parola e numeri parziali possono restringere la lista; nessun risultato è garantito.

Se il servizio è lento, dopo 600 ms appare la semplice riga “Ricerca degli indirizzi…”. Dopo dieci secondi la richiesta termina. Il cliente può continuare a inserire l’indirizzo a mano.

Campi dell’indirizzo scelto

La scelta conserva via e numero come restituiti, ad esempio Mannerheimintie 10 o Hämeenkatu 5 A. La lettera della scala A rimane se presente, così come una lettera unita al civico, ad esempio 81a. Il CAP mantiene cinque cifre, inclusi gli zeri iniziali di 00100. La città proviene da locality, in alternativa da localadmin. Nei moduli delle Åland, Maarianhamina viene scritto come Mariehamn. Il nome della città non viene convertito in maiuscolo. Paese scelto, seconda riga, nome, azienda e telefono restano invariati. Tieni appartamento, casella, piano e ingresso sulla seconda riga. Un numero di interno riconosciuto dopo una lettera di scala deve corrispondere al risultato; altrimenti non appare alcun suggerimento. Scegliere solo la via svuota il CAP; completa civico e CAP a mano. Controlla tutto l’indirizzo prima di salvare. Inserimento e modifica manuali restano possibili.

Usa per questi paesi appartiene ai moduli mondiali. Una lista vuota indica tutti i paesi disponibili nel modulo; una selezione limita quel servizio. Finnish Address ha copertura fissa della Finlandia (FI) e delle Åland (AX) senza selettore di paesi. I moduli per le Åland (AX) ricevono suggerimenti in svedese, come Torggatan 1, 22100 Mariehamn. Il CAP determina il paese sia degli indirizzi sia delle vie: 22xxx identifica le Åland. I moduli FI e AX ricevono solo risultati del proprio paese; le righe senza CAP valido vengono scartate. Funziona accanto a French Address Autocomplete, Google Address Autocomplete e Fetchify Address Autocomplete; mantienili tutti aggiornati. Le destinazioni BAN francesi sono separate dalla Finlandia e dalle Åland. Un errore di ricerca non passa automaticamente a un altro servizio.

In Clienti > Indirizzi gli operatori possono scegliere un indirizzo di Finlandia o Åland dopo una richiesta telefonica per compilare via, CAP e città. L’interruttore del back office è indipendente da account e checkout. Il codice comprende le finestre native dell’indirizzo di un nuovo ordine servite dalla pagina degli indirizzi clienti. Percorsi e moduli personalizzati richiedono una prova. Il motore condiviso supporta i moduli di indirizzo contrassegnati da un’integrazione come Checkout Revolution. L’integrazione e questo modulo condividono le stesse impostazioni del servizio per negozio.

Sul telefono tocca un risultato sotto la via. Con la tastiera usa frecce e Invio; Escape o Tab chiude l’elenco. I lettori di schermo ricevono annunci dei risultati. Il componente comune segue la presentazione Bootstrap del tema. Il credito visibile è © OpenStreetMap contributors, © Digitransit 2026. Senza corrispondenze l’elenco resta chiuso; l’indisponibilità viene annunciata. Inserimento e modifica manuali rimangono possibili. Il salvataggio non richiede una scelta e non verifica la consegnabilità.

Privacy e credito dei dati

Il browser invia testo preparato, layers=address,street, size=10, lang=fi per la Finlandia (FI) o lang=sv per le Åland (AX) e la tua chiave come parametri URL a https://api.digitransit.fi. Nessun parametro separato per nome, email, telefono, azienda, seconda riga o paese. Il contenuto della ricerca può essere trasmesso. La chiave è visibile a visitatori e servizio. Le credenziali del browser sono disabilitate; la connessione espone l’IP e può inviare dati del browser (intestazioni Origin e Referer) secondo la sua politica. La scelta non richiede dettagli aggiuntivi. La diagnostica omette testo, chiavi, URL e risposte; PrestaShop salva l’indirizzo. Cita questo trasferimento nell’informativa sulla privacy. Credito: © OpenStreetMap contributors, © Digitransit YEAR, con l’anno del server.

Limiti da conoscere

• Copertura: la Finlandia e le Åland, gli indirizzi di OpenStreetMap serviti dal geocodificatore Digitransit (Fintraffic e HSL): molto buona nelle città, mancano alcuni indirizzi rurali. I suggerimenti iniziano non appena la chiave di sottoscrizione è salvata. Completezza, freschezza, ordinamento e uso gratuito illimitato non sono promessi. Il risultato registrato Itäinen Rantakatu 2 ha due CAP: controlla l’indirizzo scelto.
• Un indirizzo richiede CAP di cinque cifre e città. Righe incomplete, errate e duplicate vengono scartate. Senza indirizzo valido e civico riconosciuto può apparire una sola via. La scelta svuota il CAP; completa civico e CAP a mano. Non è dimostrata una copertura specifica di interni, caselle o luoghi senza nome della via.
• Senza chiave non partono richieste; le autorizzazioni del servizio possono fallire con 401/403. Una risposta 429 sospende le richieste secondo Retry-After o dieci secondi. Errori di rete, risposta o timeout lasciano l’inserimento manuale. Nessun cambio automatico di servizio.
• Il filtro verifica civico, lettera di scala e interno riconosciuti. Una lettera isolata dopo il civico può essere letta per un momento come scala mentre scrivi la città. Un interno riconosciuto senza corrispondenza nasconde la lista. Moduli, temi, percorsi di nuovo ordine e versioni miste richiedono prove.
• Niente mappa, geolocalizzazione, salvataggio coordinate, convalida all’invio, selezione automatica del paese o garanzia di consegna. Modulo gratuito con aggiornamenti a vita, senza impegno di assistenza inclusa. Condizioni, quote e uso della chiave nel browser richiedono verifica aggiornata.

Se non compaiono suggerimenti

• Nessun risultato per Finlandia o Åland: controlla che la Finlandia o le Åland siano attive e verifica gli interruttori, poi via completa, numero e città. Chiave di sottoscrizione Digitransit: 32 caratteri esadecimali; 401/403.
• Funziona insieme a French Address Autocomplete, Google Address Autocomplete e Fetchify Address Autocomplete; tienili tutti aggiornati all’ultima versione.
• Sola via o nessun risultato: completa civico, CAP e località postale a mano e controlla l’indirizzo prima di salvare.
• Servizio indisponibile: verifica rete/CSP Digitransit, attendi dopo un limite e continua manualmente.
• Modulo o layout personalizzato: prova modulo nativo, tastiera/telefono e percorso ordine; controlla le impostazioni del servizio condivise per negozio.