Google Address Autocomplete

Google Address Autocomplete aggiunge Google Places ai moduli indirizzo nativi di PrestaShop. Dopo una scelta compila address1, postcode, city e, se esiste un’opzione corrispondente, la selezione nativa di stato o provincia. Il modulo è gratuito; Google fattura l’utilizzo sull’account del commerciante. La procedura configura la tua chiave, senza account di servizio condiviso.

Avvio rapido

1. Apri Google Cloud Console e crea o seleziona il progetto del negozio.
2. Collega il tuo account di fatturazione e attiva la fatturazione.
3. Nella libreria API dello stesso progetto attiva Maps JavaScript API e Places API (New).
4. Crea una chiave API nell’area credenziali del progetto.
5. Imposta la restrizione applicazione su Siti web / referrer HTTP. Autorizza l’origine reale del negozio, per esempio https://negozio.example/*. Aggiungi la variante www solo se viene usata. Aggiungi l’origine diversa del back office se necessita dei suggerimenti. Evita di autorizzare indistintamente tutti i siti.
6. Limita le API della chiave a Maps JavaScript API e Places API (New) e salva. Questa chiave è pubblica nel browser; limitarla fa parte della configurazione e non la nasconde.
7. Carica il file ZIP in PrestaShop e installa il modulo. Apri Configura in Gestione moduli, o la voce Google Address nel menu del back office, seleziona il negozio se necessario e incolla la chiave in Chiave API di Google Maps. Scegli i moduli d’indirizzo e salva.
8. Integra le origini Google nella CSP esistente se necessario e descrivi la connessione nell’informativa privacy.
9. Prova scelta e inserimento manuale nell’account, nell’ordine ospite, nella fatturazione separata e in Clienti > Indirizzi. Controlla la finestra nativa dell’indirizzo di un nuovo ordine sulla tua versione, un altro paese e la larghezza telefono. Leggi gli errori del browser e l’utilizzo nell’account Google.

Funzionalità

• Suggerimenti della via. Google Places nell’account e nell’ordine nativi, ospiti compresi.
• Compilazione insieme. Via, CAP, città e, se esiste un’opzione corrispondente nel modulo, stato o provincia dal suggerimento scelto.
• Paese selezionato. La ricerca segue la destinazione scelta nel modulo.
• Back office. Aiuto alla compilazione nella pagina nativa degli indirizzi clienti.
• Uso quotidiano. Telefono, tastiera e lettore di schermo, mantenendo l’inserimento manuale.
• Il tuo account Google. Modulo gratuito con interruttori separati per i formulari; Google ti addebita l’utilizzo.

Opzioni di configurazione

Per aprire l’unica pagina delle impostazioni, scegli Configura in Gestione moduli, o la voce Google Address nel menu del back office. La pagina riunisce configurazione, integrità, licenza, aggiornamenti e assistenza; i controlli qui sotto si trovano nella sezione di configurazione.

• Suggerisci indirizzi mentre il cliente scrive: comando generale.
• Nel modulo indirizzo dell'account cliente: inserimento nativo dell’indirizzo nell’account.
• Nei moduli indirizzo del checkout (inclusi ospiti e indirizzi di fatturazione separati): ordine nativo, ospiti e indirizzo di fatturazione separato.
• Nel modulo indirizzo del back office (indirizzi dei clienti, nuovi ordini): Clienti > Indirizzi, compresa una finestra di nuovo ordine servita da quella pagina.
• Usa per questi paesi: lascia vuoto per suggerire indirizzi in tutti i paesi, oppure scegli i paesi in cui risponde Google. Se un altro modulo di indirizzi copre anche un paese, lì risponde il modulo limitato a un elenco di paesi. La pagina avvisa quando due moduli di indirizzi attivi coprono entrambi tutti i paesi.
• Chiave API di Google Maps: la tua chiave pubblica per browser.

Gli interruttori sono inizialmente attivi. I suggerimenti Google restano comunque spenti finché non salvi una chiave. Svuotare il campo della chiave interrompe Google e mantiene il modulo ordinario. Il salvataggio verifica il formato della chiave, non l’accettazione da parte di Google. La pagina non ha un pulsante di verifica reale della chiave.

In multinegozio seleziona un solo negozio che sei autorizzato a gestire. Le impostazioni vengono salvate per quel negozio. Il comando generale deve essere attivo insieme a quello del modulo d’indirizzo. Spegnere l’ordine mantiene attivi account e back office se sono abilitati.

La pagina spiega copertura, fatturazione, privacy e CSP. Le stringhe delle impostazioni esistono in inglese, tedesco, francese, polacco, italiano e spagnolo. È l’elenco delle lingue delle impostazioni, non una garanzia sui dati degli indirizzi in ogni lingua.

Esempi di personalizzazione

Iniziare dagli indirizzi inseriti dal team

Lascia attivi comando generale e back office, spegnendo account e ordine. Salva una chiave correttamente limitata e prova un indirizzo in Clienti > Indirizzi. Attiva i moduli dei clienti dopo le rispettive prove. Questi interruttori scelgono le posizioni, non i paesi di vendita.

Consentire Google nella Content Security Policy

Se il tuo negozio invia una Content Security Policy, aggiungi le origini Google alle direttive esistenti. Il modulo carica lo script Google da https://maps.googleapis.com e chiede i suggerimenti e l’indirizzo scelto tramite https://maps.googleapis.com e https://places.googleapis.com. L’SDK Google può caricare dipendenze anche da https://maps.gstatic.com senza mostrare una mappa. L’esempio qui sotto copre solo le origini indicate nel modulo; integra la politica esistente per le dipendenze effettivamente caricate dall’SDK. Mantieni le altre fonti e, mentre provi i suggerimenti, controlla la console del browser. Con French Address Autocomplete attivo aggiungi anche https://data.geopf.fr a connect-src.

script-src 'self' https://maps.googleapis.com;
connect-src 'self' https://maps.googleapis.com https://places.googleapis.com;

Conservare appartamento e indicazioni di consegna

Inserisci un piano o un appartamento nella seconda riga, poi scegli un risultato. La seconda riga resta invariata. Completa un numero civico mancante prima di salvare. Nessuna impostazione obbliga a scegliere una voce e il modulo non aggiunge una verifica dell’indirizzo all’invio.

Installazione

Requisiti

• Intervallo generale PrestaShop: PS 1.6 – 9.x. Minimo esatto dichiarato: PrestaShop 1.6.1.0; PHP 7.1 o successivo.
• Campi nativi e tema Bootstrap 3, 4 o 5 per l’aspetto supportato dell’elenco.
• Un tuo progetto Google Cloud, account di fatturazione e chiave per browser. Google ti addebita l’utilizzo.

Se un altro modulo di indirizzi carica un vecchio motore che disattiva i suggerimenti, aggiorna il modulo indicato nella pagina delle impostazioni di questo modulo.

Salvare una chiave formalmente valida non dimostra che API, fatturazione e referrer siano corretti. Se un altro modulo ha già caricato Google Maps con importLibrary, viene riutilizzato quel caricamento. Anche la sua chiave deve avere Places API (New) abilitata. La chiave salvata qui non sostituisce automaticamente l’altra integrazione.

Come funziona

I suggerimenti iniziano dopo 3 caratteri e una pausa di 300 ms, con un massimo di 5 risultati. Sono valori incorporati, non impostazioni. Durante la digitazione vengono inviate ricerche a Google: «una richiesta di dettagli» non significa «una sola richiesta Google nell’intera visita». Se una richiesta dura più di 600 ms, sotto il campo della via appare “Ricerca degli indirizzi…”.

L’adattatore usa AutocompleteSuggestion.fetchAutocompleteSuggestions e un AutocompleteSessionToken. Solo la scelta di una voce richiama toPlace() e una volta fetchFields({fields: ['addressComponents']}). La sessione successiva parte con un nuovo token. Questo descrive il codice e non garantisce categorie o tariffe di fatturazione Google. I dettagli non vengono richiesti per ogni voce soltanto visualizzata.

Quali dati vengono compilati dopo la scelta

Mantiene il paese selezionato e conserva appartamento, piano o ingresso già indicati nella seconda riga. Nome, azienda e telefono restano invariati. Il cliente rilegge e modifica il risultato prima di salvare: l’aiuto riduce la digitazione senza decidere al suo posto quale sia l’indirizzo da usare.

Per quali paesi compaiono i suggerimenti Google

La ricerca segue il paese selezionato nel modulo dell’indirizzo. Il modulo interroga Google Places per i paesi proposti dal negozio, senza una lista limitata alla Francia. Cambiare paese cambia la ricerca. I risultati dipendono dai dati e dalla disponibilità di Google: non è garantita la presenza di ogni via e di ogni numero civico. Si compilano anche gli indirizzi in Giappone e a Hong Kong, usando aree amministrative o quartieri per la città quando necessario; Hong Kong non ha codici postali.

Un negozio che usa più moduli di indirizzi decide con Usa per questi paesi quale risponde in ciascun paese, per esempio un servizio di indirizzi britannico per il Regno Unito e Google per tutti gli altri. Un modulo limitato a un elenco di paesi risponde lì per primo, quindi French Address Autocomplete mantiene le sue destinazioni francesi. Senza selezione, Google suggerisce indirizzi in tutti i paesi.

Dove riceve aiuto il team nel back office

In Clienti > Indirizzi i collaboratori ricevono suggerimenti anche nel campo nativo della via. La scelta compila via, CAP, città e, se esiste un’opzione corrispondente nel modulo, stato o provincia, per esempio dopo una richiesta telefonica o mentre si prepara un ordine. L’interruttore del back office è indipendente da quelli dell’account e dell’ordine. Attivi l’aiuto nei punti in cui il team inserisce davvero gli indirizzi.

Come si sceglie un risultato da telefono o tastiera

Dal telefono il cliente tocca un suggerimento sotto il campo della via. Con la tastiera, le frecce scorrono i risultati ed Enter sceglie quello evidenziato. Escape o Tab chiude l’elenco senza scegliere. L’elenco segue l’aspetto delle liste del tema e rimane accanto ai campi in compilazione, senza aprire una mappa o una pagina di ricerca separata.

Richieste, indirizzi salvati e privacy

Il browser carica Google Maps con la chiave pubblica. Le richieste di suggerimenti inviano esplicitamente testo della via, paese selezionato, lingua della pagina e token di sessione. La scelta identifica il luogo e richiede i componenti del suo indirizzo. Google vede l’IP della connessione e riceve eventualmente informazioni sul browser o sul referrer secondo la politica del browser.

Il modulo non aggiunge nome, e-mail, telefono, azienda o seconda riga a queste richieste. Non inoltra le ricerche tramite il server del negozio e non conserva testi o risultati nelle proprie tabelle. Ciò non significa che Google non conservi nulla. Il successivo salvataggio dell’indirizzo resta la normale operazione PrestaShop. Indica il trasferimento nell’informativa; installare il modulo non risolve automaticamente le questioni di consenso o altri obblighi di privacy.

L’elenco riporta Google Maps. La diagnostica opzionale del motore registra stato tecnico, fornitore, paese, durata e numero di risultati, senza l’indirizzo digitato. Non crea una cronologia delle ricerche.

Limiti da conoscere

• Account Google necessario. Il modulo gratuito non include l’utilizzo Google. Fatturazione, API abilitate e restrizioni web sono a carico del commerciante.
• Copertura senza completezza. La ricerca segue il paese. Potrebbe mancare un risultato, il civico, il CAP o componenti utilizzabili per via e città.
• Moduli nativi. Ordini personalizzati, finestre di terzi e temi senza Bootstrap richiedono prove proprie. La finestra del nuovo ordine è quella servita da AdminAddresses.
• Inserimento manuale. I suggerimenti non verificano l’indirizzo inviato e non garantiscono la consegna. Il cliente controlla la destinazione.
• Campi conservati. Seconda riga, nome, azienda, telefono e paese selezionato restano invariati.
• Risposte in ritardo. Un cambio di paese o di valori, campi necessari assenti o testi troppo lunghi possono fermare la compilazione. L’inserimento manuale rimane disponibile.
• Servizio esterno. Rete, politica del browser e account influenzano i suggerimenti. Una richiesta BAN fallita non passa automaticamente a Google.
• Impostazioni condivise. Quando Checkout Revolution usa questo motore condiviso degli indirizzi, usa le stesse impostazioni per negozio di questo servizio.
• Nessuna mappa o posizione. Il modulo non richiede né salva coordinate. Uno script condiviso nella pagina potrebbe servire un’altra integrazione.
• Classificazione della fatturazione. Token e campo richiesto sono verificati nel codice. La classificazione Essentials corrente e l’idoneità alla tariffazione per sessione non sono stabilite qui. Controlla le condizioni attuali nel tuo account Google; nessun importo o credito è promesso.

Se non compaiono suggerimenti

• Nessun suggerimento: controlla l’interruttore generale, quello del modulo d’indirizzo e la chiave per browser salvata. Attiva Maps JavaScript API, Places API (New) e la fatturazione nel relativo progetto Google Cloud. Verifica che le restrizioni dei referrer HTTP autorizzino le origini effettive del negozio e del back office.
• Richieste bloccate dalla CSP: aggiungi alla politica esistente le origini Google misurate riportate negli esempi di personalizzazione. Controlla i blocchi nella console del browser; l’esempio non sostituisce una politica completa.
• Errore Google nella console: leggi l’errore Google nel browser e controlla chiave, API, fatturazione e referrer. Se la pagina carica già Google Maps con importLibrary, controlla anche la chiave di quel caricamento. Il salvataggio nel modulo verifica soltanto il formato.
• Paese o indirizzo non coperto: controlla il paese scelto nel modulo d’indirizzo. I risultati dipendono dai dati e dalla disponibilità Google; un paese disponibile non garantisce ogni indirizzo. Continua con l’inserimento manuale se nessun risultato corrisponde.
• Nessun CAP restituito: Google può restituire un indirizzo senza CAP, anche per paesi che non usano codici postali. Il campo può restare vuoto. Controlla e completa l’indirizzo a mano dove il CAP è necessario.