Che cosa fa?

Il completamento automatico degli indirizzi per Gravity Forms aiuta gli utenti a inviare indirizzi accurati più velocemente mostrando suggerimenti basati su Google durante la digitazione. Funziona con entrambi Indirizzo e Testo su una sola riga campi.

Quando un utente seleziona un suggerimento, il plugin può anche acquisire metadati utili sulla posizione (come ID luogo e coordinate) e mappare le parti chiave dell'indirizzo, o persino eseguire una ricerca del codice postale, per compilare campi dedicati (inclusi quelli nascosti) per la pianificazione dei percorsi, l'automazione o la creazione di report.

Caratteristiche

Completamento dell'indirizzo più rapido
Gli utenti ricevono suggerimenti da Google mentre digitano, riducendo il numero di tasti premuti e velocizzando l'invio dei moduli.
Compatibile con i campi Indirizzo + Testo su riga singola
Abilita il completamento automatico per entrambi i tipi di campo, in modo da poter mantenere i layout dei moduli esistenti.
Mappatura dei campi analizzati
Inserisci Indirizzo riga 1, Riga 2, Città/Paese, Stato/Regione, Codice Postale/CAP e Paese in uno qualsiasi dei campi selezionati dello stesso modulo, inclusi i campi nascosti.
Gestione degli indirizzi compatibile con i paesi
Supporta indirizzi globali e utilizza etichette neutre rispetto al paese nelle impostazioni per i team al di fuori degli Stati Uniti.
Limita i risultati per paese
Limita i suggerimenti a paesi specifici utilizzando i codici ISO (ad esempio, Stati Uniti, Canada, Regno Unito).
Metadati salvati con ogni voce
Memorizza l'ID del luogo, la latitudine, la longitudine e l'indirizzo formattato per integrazioni, automazione e risoluzione dei problemi.
Compatibile con WordPress Multisite
Attiva la rete una sola volta per utilizzarla su tutti i tuoi sottositi. (La modalità di rete è disponibile con i piani Unlimited.)
Traduzione pronta
Completamente compatibile con il plugin di traduzione scelto.Le traduzioni preliminari non sono incluse, ma arriveranno presto.)
Ricerca del codice postale
Trasforma un singolo campo in una ricerca per CAP/codice postale che compila automaticamente i campi Città e Provincia/Regione (inclusi quelli nascosti): ideale per i moduli "verifica la tua zona" e per l'instradamento CRM.

Vai ai dettagli della funzionalità

Come faccio ad abilitare il plugin?

Dopo aver acquistato Address Autocomplete per Gravity Forms, dovrai:

Installa il plugin sul tuo sito web WordPress.
Genera e inserisci la tua chiave API di Google.
Abilita il completamento automatico su un indirizzo o Campo di testo su riga singola.

Le istruzioni seguenti ti mostreranno come installare il plugin, generare una chiave API di Google per il completamento automatico degli indirizzi e abilitarlo in un campo Indirizzo o in un campo di testo a riga singola.

Registra il plugin con Plugin Brewery

Genera e inserisci la chiave API di Google

Prima di poter utilizzare la funzione di completamento automatico degli indirizzi, è necessario generare una chiave API nella console di Google Cloud Platform.

Abilita nei campi indirizzo

Abilita nei campi di testo a riga singola

Generazione di una chiave API di Google

Crea o seleziona un progetto Google Cloud esistente

Prima di poter ottenere la tua chiave API di Google, devi crea un nuovo Progetto Google Cloud Platform (oppure selezionane uno esistente se ne possiedi già uno).

Nota: se stai creando un nuovo progetto GCP, ti consigliamo di definirne l'ambito per il sito web su cui stai lavorando, nel caso in cui avessi bisogno di altri servizi API di Google per lo stesso sito web.

Abilita le API richieste

Dopo aver creato o selezionato un progetto Google Cloud, vai su API e servizi > Libreria API e abilita le seguenti API:

Nota: Google richiede che un account di fatturazione sia collegato al tuo progetto prima di poter abilitare l'API Places. Per la maggior parte dei siti, l'utilizzo rientra nel piano gratuito di Google, ma è comunque necessario un metodo di pagamento.

API Luoghi (Nuova)

Collegamento rapido

Potresti notare "Places API" e "Places API (New)" – Il nostro plugin è progettato per essere compatibile con "Places API (New)".“

API Javascript di Maps

Collegamento rapido

Genera chiave

Ora che entrambe le API sono abilitate nel tuo progetto, puoi generare la tua chiave API.

Vai a API e servizi > credenziali, quindi fai clic su “+ Crea credenziali” e infine fai clic su “Chiave API”

Si aprirà una finestra di dialogo laterale in cui potrai assegnare un nome al tasto.

A questo punto, puoi scorrere verso il basso e cliccare su "Crea" e la tua chiave verrà generata immediatamente, TUTTAVIA... dovresti impostare una restrizione su di essa nel passaggio successivo per impedire l'uso non autorizzato della tua chiave.

Nota: questo è molto importante! Le chiavi sono visibili, quindi non vorrai che malintenzionati rubino il tuo utilizzo gratuito.

Continua a scorrere fino a "Restrizioni dell'applicazione" nella finestra di dialogo.

Nella sezione “Restrizioni dell’applicazione” selezionare “Siti Web”

Nella sezione "Restrizioni del sito web" aggiungi i siti web sui quali deve essere utilizzata la chiave API. Non aggiungere https.

Si consiglia di aggiungere un dominio jolly per garantire che la chiave funzioni sia su domini con www che senza www, in questo modo: *.example-website.com/*

Fai clic su Crea e la tua chiave apparirà successivamente.

Ora la tua chiave API è stata creata! Copiala e incollala nelle impostazioni di completamento automatico degli indirizzi del plugin e il gioco è fatto!

Formattazione del dominio: Inserisci ciascun dominio su una riga separata utilizzando il formato example.com/* - NO https://, nessuna barra finale sul dominio stesso, ma includi /* alla fine per consentire tutte le pagine. Per coprire tutti i sottodomini (come www), aggiungere una voce separata come *.example.com/*. Per lo sviluppo locale, utilizzare localhost o localhost:3000/* a seconda della configurazione.

yourdomain.com/*
*.yourdomain.com/*
staging.yourdomain.com/*
localhost:8080/*

Termini di servizio e informativa sulla privacy di Google

Plugin Brewery Address Autocomplete invia i dati del modulo ai servizi di Google per alimentare le ricerche di indirizzi. Secondo le linee guida di Google, qualsiasi applicazione che utilizza l'API Places dovrebbe visualizzare un collegamento a Google Termini di servizio e informativa sulla privacy.

A seconda del Paese o della regione in cui ti trovi, potrebbe essere necessario ottenere il consenso dell'utente prima di raccogliere i dati di geolocalizzazione.

Dettagli della funzione

Tipi di campo supportati

Funziona con entrambi i tipi di campo di Gravity Forms:

Campo indirizzo (input multiplo)
Testo su una sola riga (inserimento indirizzo su una sola riga)

Utilizza i campi Indirizzo quando desideri i sottocampi indirizzo nativi di GF, oppure il campo Testo su riga singola quando preferisci un layout del modulo più semplice.

Mappatura degli indirizzi analizzati (nuova)

Nel modulo, mappa i componenti dell'indirizzo selezionati in campi dedicati:

Indirizzo Linea 1
Riga indirizzo 2
Postale / CAP
Città / Paese
Stato / Provincia / Regione
Paese

Ideale per i campi nascosti utilizzati nei controlli delle zone di consegna, nell'instradamento CRM, nelle notifiche condizionali e nell'automazione.

Ricerca codice postale (Novità)

Trasforma un campo di testo a riga singola in un campo di ricerca per codice postale. Abilita il completamento automatico dell'indirizzo, quindi attiva la ricerca per codice postale nelle impostazioni avanzate del campo.

I suggerimenti sono limitati ai codici postali.
Il campo conserva solo il codice selezionato (non l'indirizzo completo).
Città, Stato/Regione (e Paese/Contea, se mappato) vengono compilati automaticamente, anche nei campi nascosti.
Funziona per qualsiasi paese dotato di codici postali.

Ideale per verifiche delle aree di servizio, logiche di spedizione e invio di dati di geolocalizzazione precisi al tuo CRM.

Gestione postale/CAP su una singola riga di testo

Per i campi di testo a riga singola, il plugin utilizza l'indirizzo formattato da Google e aggiunge il codice postale quando è disponibile ma mancante nel testo visualizzato. Se Google non restituisce un codice postale per un risultato, non è possibile aggiungerlo.

Metadati salvati nella voce Meta

Quando gli utenti selezionano un suggerimento, il plugin memorizza:

ID del luogo
Latitudine
Longitudine
Indirizzo formattato

Restrizioni per Paese + Supporto Internazionale

È possibile limitare i suggerimenti a paesi specifici con codici ISO alpha-2 (ad esempio: US,CA,GB), oppure lasciare senza restrizioni per i moduli globali.

Le etichette e le opzioni di mappatura sono indipendenti dal paese, quindi i flussi di lavoro rimangono chiari sia per i team statunitensi che per quelli di altri paesi.

Prestazioni + Compatibilità

Progettato per l'utilizzo in contesti di produzione reali:

Gli script front-end vengono inizializzati solo dove sono presenti campi abilitati
Compatibile con i flussi Gravity Forms standard e AJAX
Compatibile con le comuni configurazioni di caching/CDN nella maggior parte delle configurazioni

Tag di unione

Quando un visitatore seleziona un suggerimento di completamento automatico, il plugin può memorizzare metadati relativi alla voce. È possibile inserire tali dati nelle conferme, nelle notifiche e in altri punti che supportano i tag di unione di Gravity Forms.

Formato: {pb_aac:ID:KEY}

Sostituisci ID con l'ID del campo Indirizzo o Testo su riga singola per cui è abilitato il completamento automatico dell'indirizzo (lo stesso campo in cui vengono visualizzati i suggerimenti).

Chiavi disponibili (KEY):

CHIAVE	Cosa produce
`place_id`	ID del luogo di Google
`lat`	Latitudine
`lng`	Longitudine
`formatted`	Indirizzo formattato (stringa formattata da Google)
`google_maps_url`	Un URL di ricerca di Google Maps creato a partire dall'ID del luogo (o dalle coordinate latitudine/longitudine se l'ID del luogo non è presente).

Esempi (se il campo di completamento automatico è il campo 12):

{pb_aac:12:place_id}
{pb_aac:12:lat}
{pb_aac:12:lng}
{pb_aac:12:formatted}
{pb_aac:12:google_maps_url}

Selettore: nell'editor del modulo, i campi abilitati ricevono anche questi tag nel selettore dei tag di unione sotto etichette come "Completamento automatico indirizzo: ...".

Nota: I valori esistono solo per le voci in cui è stato selezionato un suggerimento e i metadati sono stati salvati; altrimenti il tag risulta vuoto (per impostazione predefinita).

Domande frequenti

L'API di Google Places è gratuita?

Google applica automaticamente un credito mensile di $200 al tuo account, che viene utilizzato per la fatturazione dell'utilizzo dell'API Places. Per la maggior parte dei siti, questo importo copre tutti i costi: alle tariffe attuali, circa 10.000 sessioni di completamento automatico al mese rientrano in tale credito.

Detto questo, i prezzi possono cambiare, quindi controlla il Tabella dei prezzi della piattaforma Google Maps per i dati più recenti.

Posso utilizzarlo con il campo "Testo su riga singola"?

Sì! Oltre al campo Indirizzo standard, è possibile abilitare il completamento automatico su qualsiasi campo di testo a riga singola. Ideale per i moduli che richiedono l'inserimento di un solo indirizzo.

Funziona anche con gli indirizzi internazionali?

Certamente. Il plugin supporta i dati globali degli indirizzi di Google.

La configurazione è complicata?

Assolutamente no. Basta aggiungere la chiave API di Google nelle impostazioni del plugin, abilitare il completamento automatico sui campi desiderati e il gioco è fatto. È semplicissimo.

Posso limitare i risultati a specifici paesi?

Sì. Nelle impostazioni del campo, fornire un elenco separato da virgole di codici paese ISO 3166-1 alpha-2 (ad esempio, US,CA,GB).

Quale API di Google Places devo abilitare in Google Cloud?

Abilita "Places API (New)" poiché la precedente "Places API" verrà dismessa e verrà sostituita dalla "Maps JavaScript API".

Posso utilizzare i metadati dell'indirizzo nelle notifiche o nelle integrazioni?

Sì. La funzione di completamento automatico degli indirizzi aggiunge tag di unione per ID luogo, latitudine, longitudine, indirizzo formattato e URL di Google Maps. Utilizza lo strumento di selezione dei tag di unione di Gravity Forms in qualsiasi notifica, conferma o mappatura del feed.

Gli sviluppatori possono personalizzare i risultati di ricerca di Google?

Sì. Usa il pb_aac_request Filtro JavaScript per personalizzare la richiesta, ad esempio per dare maggiore rilevanza ai risultati in una determinata area geografica, aggiungere un riquadro di delimitazione o estendere la ricerca per includere le aziende.

Posso utilizzare un campo per la ricerca del codice postale?

Sì. In un campo di testo a riga singola, abilita il completamento automatico dell'indirizzo e poi attiva la ricerca del codice postale. Il campo mostrerà suggerimenti di CAP/codice postale e, selezionandone uno, verranno compilati automaticamente i campi Città e Provincia/Regione scelti (inclusi quelli nascosti). Ottimo per moduli del tipo "verifica la tua zona" e per l'instradamento CRM.

	Accedi al tuo sito web WordPress e vai su Plugin > Aggiungi plugin > Carica plugin > Installa il file zip e attivalo. Una volta attivato, il plugin compare in Moduli > Componenti aggiuntivi > Installati e le sue impostazioni si trovano in Moduli > Impostazioni > Completamento automatico indirizzi.
	Nel menu di navigazione a sinistra, vai su Moduli > Impostazioni > Completamento automatico indirizzo > Licenza. Inserisci la tua chiave di licenza e attivala. Successivamente, passa alle impostazioni di generazione della chiave API di Google riportate di seguito.