Swiss Address Autocomplete

Swiss Address Autocomplete è un modulo PrestaShop gratuito per gli indirizzi in Svizzera e Liechtenstein. I clienti scelgono un suggerimento sotto il campo della via per compilare via e numero civico, CAP a quattro cifre e città. geo.admin.ch fornisce i dati del registro ufficiale svizzero degli indirizzi degli edifici di swisstopo, senza account, chiave o costo per ricerca.

Avvio rapido

1. Installa lo ZIP del modulo in PrestaShop. Nessun account geo.admin.ch, chiave o pagamento necessario.
2. Apri Configura oppure la voce Swiss Address nel menu del back office; nel multinegozio scegli un negozio che puoi gestire.
3. Verifica che il paese di destinazione, Svizzera o Liechtenstein, sia disponibile e attivo per i moduli del front office usati.
4. Scegli nell’ordine gli interruttori generale, account, checkout e back office, poi salva. Nessun selettore di paesi qui.
5. Funziona insieme a French Address Autocomplete, Google Address Autocomplete e Fetchify Address Autocomplete; tienili tutti aggiornati all’ultima versione.
6. Aggiungi l’origine geo.admin.ch a una CSP esistente e cita la connessione del navigatore nell’informativa sulla riservatezza.
7. Scegli la Svizzera e prova Bahnhofstrasse 10 Zürich o aggiungi un CAP. Per il Liechtenstein, seleziona quel paese e prova Vaduz o Schaan. Controlla via, numero, CAP a quattro cifre e città. Prova inserimento manuale, ospiti, fattura, team/nuovo ordine, Francia e larghezza telefono.

Funzionalità

• Suggerimenti di vie di Svizzera e Liechtenstein. Dati ufficiali degli edifici swisstopo nei moduli nativi di account e checkout, anche per ospiti.
• Campi compilati insieme. Via e numero civico, CAP a quattro cifre e città dell’indirizzo scelto.
• Copertura fissa Svizzera e Liechtenstein. Ricerca con via e numero; anche il testo del CAP può restringere i risultati.
• Back office. Lo stesso aiuto postale per il team in Clienti > Indirizzi.
• Uso quotidiano. Touch, tastiera e annunci per lettori di schermo; inserimento manuale mantenuto.
• Senza account del servizio. Modulo gratuito, dati nazionali gratuiti, quattro interruttori e nessuna chiave.

Opzioni di configurazione

• Suggerisci indirizzi mentre il cliente scrive: interruttore generale, primo campo.
• 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 Configura in Gestione moduli oppure la voce Swiss Address nel menu del back office. La pagina unica contiene Configurazione, Integrità, Licenza, Aggiornamento e Assistenza. I quattro interruttori seguono l’ordine sopra, poi Salva; sono tutti attivi per impostazione predefinita. Nessun campo chiave, account o paese. Nel multinegozio scegli un negozio autorizzato. Dopo il modulo trovi copertura/servizio gratuito/CAP, inserimento manuale, riservatezza e CSP, poi i servizi della famiglia. Testi disponibili in inglese, tedesco, francese, polacco, italiano e spagnolo; non significa dati di indirizzo in sei lingue. La sezione Assistenza non dà diritto ad assistenza inclusa.

geo.admin.ch serve la Svizzera e il Liechtenstein quando scegli il paese corrispondente nel modulo. I risultati corrispondono al paese scelto, ad esempio Vaduz e Schaan per il Liechtenstein. Con la Francia i suggerimenti svizzeri si fermano; French Address Autocomplete può rispondere con BAN se attivo per lo stesso modulo. Le destinazioni di spedizione del negozio non cambiano.

Google Address Autocomplete o Fetchify Address Autocomplete possono servire altri paesi con configurazione separata. Una ricerca svizzera fallita non passa automaticamente a un altro servizio.

Usa per questi paesi appartiene ai moduli mondiali della famiglia. La lista limita la loro copertura; vuota significa tutti i paesi disponibili nel modulo. Swiss Address resta fisso su CH + LI e non ha questo campo. Funziona insieme a French Address Autocomplete, Google Address Autocomplete e Fetchify Address Autocomplete; tienili tutti aggiornati all’ultima versione.

Esempi di personalizzazione

Consenti geo.admin.ch nella politica di sicurezza dei contenuti

Origine esterna ricavata dal codice: https://api3.geo.admin.ch in connect-src. Non si caricano SDK svizzeri o fogli di stile esterni. Unisci l’esempio alla politica esistente, mantenendo le regole del tema, del codice incorporato, dei valori monouso e degli altri moduli. Con French Address Autocomplete autorizza anche https://data.geopf.fr in connect-src. Funziona insieme a French Address Autocomplete, Google Address Autocomplete e Fetchify Address Autocomplete; tienili tutti aggiornati all’ultima versione.

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

Conserva appartamento e dettagli di consegna

Scrivi appartamento o piano nella seconda riga prima della scelta. La riga resta intatta. Controlla via, numero, CAP e città prima di salvare. Nessun cantone viene compilato; aggiungilo manualmente se richiesto. I suggerimenti sono facoltativi e la ricerca CAP non è un elenco completo degli indirizzi.

Installazione

Requisiti

• Intervallo generale PrestaShop: PS 1.6 – 9.x. Minimo dichiarato esatto: PrestaShop 1.6.1.0 e PHP 7.1 o successivo.
• Campi di indirizzo nativi e presentazione Bootstrap 3, 4 o 5. Il paese di destinazione, Svizzera o Liechtenstein, deve essere disponibile e attivo sul front office se spedisci lì.
• Questo modulo non richiede account del servizio, chiave, pagamenti o installazione di dati dei cantoni. Completa manualmente i cantoni obbligatori.

Funziona insieme a French Address Autocomplete, Google Address Autocomplete e Fetchify Address Autocomplete; tienili tutti aggiornati all’ultima versione.

Swiss Address funziona da solo. L’installazione non certifica ogni piattaforma, tema o risposta del servizio. Funziona insieme a French Address Autocomplete, Google Address Autocomplete e Fetchify Address Autocomplete; tienili tutti aggiornati all’ultima versione.

Come funziona

I suggerimenti iniziano dopo tre caratteri e 300 ms di pausa. Un GET diretto del navigatore invia searchText, type=locations, origins=address, limit=10 e sr=4326 al SearchServer geo.admin.ch. Restano solo etichette di indirizzi numerati leggibili con CAP a quattro cifre e città. I duplicati sono rimossi e compaiono al massimo cinque opzioni. La scelta usa l’indirizzo già ricevuto senza altro recupero.

Se un servizio è lento, appare “Ricerca degli indirizzi…”; dopo dieci secondi la richiesta svizzera termina e l’inserimento manuale resta disponibile.

Campi dell’indirizzo scelto

L’adattatore rimuove i marcatori e decodifica le entità supportate nell’etichetta. Il testo prima di CAP/città in grassetto fornisce via e ultimo elemento numerato. Via, spazio e numero compilano address1; NNNN compila postcode; la città compila city. Nessuna trasformazione delle maiuscole o dati cantonali. Paese, seconda riga e campi personali/azienda/telefono non sono compilati. Modifiche, cambio di paese, campi assenti o limiti di lunghezza possono rifiutare la compilazione.

geo.admin.ch serve la Svizzera e il Liechtenstein quando scegli il paese corrispondente nel modulo. I risultati corrispondono al paese scelto, ad esempio Vaduz e Schaan per il Liechtenstein. Con la Francia i suggerimenti svizzeri si fermano; French Address Autocomplete può rispondere con BAN se attivo per lo stesso modulo. Le destinazioni di spedizione del negozio non cambiano.

Google Address Autocomplete o Fetchify Address Autocomplete possono servire altri paesi con configurazione separata. Una ricerca svizzera fallita non passa automaticamente a un altro servizio.

Usa per questi paesi appartiene ai moduli mondiali della famiglia. La lista limita la loro copertura; vuota significa tutti i paesi disponibili nel modulo. Swiss Address resta fisso su CH + LI e non ha questo campo. Funziona insieme a French Address Autocomplete, Google Address Autocomplete e Fetchify Address Autocomplete; tienili tutti aggiornati all’ultima versione.

In Clienti > Indirizzi il team può inserire un indirizzo in Svizzera o Liechtenstein dopo una richiesta telefonica. Una scelta compila i campi nativi di via, CAP e città. L’interruttore del back office è indipendente da account e checkout, insieme all’interruttore generale.

Il codice riguarda anche le finestre native di indirizzo dei nuovi ordini servite da AdminAddresses. Percorsi e moduli personalizzati richiedono verifiche. Quando Checkout Revolution usa questo motore condiviso degli indirizzi, usa le stesse impostazioni per negozio di questo servizio.

Sul telefono il cliente tocca un risultato sotto la via. Con la tastiera usa frecce e Invio; Escape o Tab chiude la lista. I lettori di schermo ricevono annunci dei risultati. La lista condivisa segue la presentazione Bootstrap del tema.

La lista mostra il credito © swisstopo. Senza risultati resta chiusa; un errore del servizio annuncia suggerimenti non disponibili. Inserimento e correzioni manuali restano possibili. Il salvataggio non richiede una scelta e non convalida l’indirizzo di consegna all’invio.

Privacy e credito dei dati

Tutto ciò che scrivi nella ricerca è inviato come searchText, compreso un CAP o dati personali digitati in quel campo. Nessun parametro separato per nome, e-mail, telefono, azienda, seconda riga, lingua o paese scelto. Credenziali disattivate e limite di dieci secondi. La connessione diretta espone IP e può trasmettere dati del navigatore (intestazioni Origin e Referer) secondo le sue regole. Il modulo non conserva cronologia delle ricerche né usa un proxy del negozio; la diagnostica omette testi e risposte. Gli indirizzi scelti vengono salvati normalmente da PrestaShop. Credito visibile: © swisstopo. Spiega il trasferimento nell’informativa sulla riservatezza.

Limiti da conoscere

• Copertura, ordine e disponibilità dipendono da geo.admin.ch; né ogni indirizzo né il servizio continuo sono garantiti. Il CAP non promette risultati completi o uso illimitato.
• Solo indirizzi numerati leggibili con CAP a quattro cifre e città diventano scelte. Cantone e altri dettagli obbligatori vanno completati da te.
• Le risposte 429 sospendono le richieste secondo Retry-After o dieci secondi. Timeout, errori di rete e risposte non valide lasciano l’inserimento manuale; nessun cambio automatico di servizio.
• Moduli/temi personalizzati e finestre di nuovi ordini con altri percorsi richiedono test. Quando Checkout Revolution usa questo motore condiviso degli indirizzi, usa le stesse impostazioni per negozio di questo servizio.
• Nessuna mappa, geolocalizzazione, memorizzazione di coordinate, convalida all’invio, scelta automatica del paese o garanzia di consegna. Modulo gratuito con aggiornamenti a vita, senza promessa di assistenza inclusa.

Se non compaiono suggerimenti

• Nessun risultato in Svizzera o Liechtenstein: seleziona il paese di destinazione, verifica attività e interruttori generale/modulo, poi prova via completa + numero + città o CAP.
• Funziona insieme a French Address Autocomplete, Google Address Autocomplete e Fetchify Address Autocomplete; tienili tutti aggiornati all’ultima versione.
• Campi inattesi o mancanti: controlla l’indirizzo numerato scelto e completa manualmente cantone o altri dettagli richiesti.
• Suggerimenti non disponibili: controlla rete/CSP per api3.geo.admin.ch, attendi dopo un limite e continua manualmente.
• Modulo personalizzato o problema grafico: prova un modulo nativo, telefono/tastiera e percorso nuovo ordine; controlla le impostazioni del servizio condivise per negozio.