Apa Kegunaannya?

Fitur Pelengkapan Otomatis Alamat untuk Gravity Forms membantu pengguna mengirimkan alamat yang akurat lebih cepat dengan menampilkan saran berbasis Google saat mereka mengetik. Berfungsi dengan keduanya. Alamat dan Teks Satu Baris ladang.

Saat pengguna memilih saran, plugin juga dapat menangkap metadata lokasi yang berguna (seperti ID Tempat dan koordinat) dan memetakan bagian alamat utama – atau bahkan menjalankan pencarian kode pos – untuk mengisi kolom khusus (termasuk yang tersembunyi) untuk perutean, otomatisasi, atau pelaporan.

Fitur

Penyelesaian alamat lebih cepat
Pengguna mendapatkan saran yang didukung Google saat mereka mengetik, mengurangi jumlah penekanan tombol dan mempercepat pengiriman.
Berfungsi dengan kolom Alamat + Teks Satu Baris
Aktifkan fitur pelengkapan otomatis pada kedua jenis kolom, sehingga Anda dapat mempertahankan tata letak formulir yang sudah ada.
Pemetaan bidang yang diuraikan
Kirimkan Alamat Baris 1, Baris 2, Kota/Kabupaten, Provinsi/Wilayah, Kode Pos/ZIP, dan Negara ke kolom mana pun yang dipilih pada formulir yang sama, termasuk kolom tersembunyi.
Penanganan alamat yang ramah internasional
Mendukung alamat global dan menggunakan label netral negara dalam pengaturan untuk tim di luar AS.
Batasi hasil berdasarkan negara
Batasi saran hanya pada negara-negara tertentu yang menggunakan kode ISO (misalnya, AS, Kanada, Inggris).
Metadata disimpan bersama setiap entri.
Menyimpan ID lokasi, garis lintang, garis bujur, dan alamat yang diformat untuk integrasi, otomatisasi, dan pemecahan masalah.
Kompatibel dengan WordPress Multisite
Aktifkan jaringan sekali untuk menggunakannya di semua sub-situs Anda. (Mode Jaringan tersedia pada paket Unlimited.)
Terjemahan siap
Sepenuhnya kompatibel dengan plugin terjemahan yang Anda pilih.Terjemahan awal belum termasuk, tetapi akan segera tersedia.)
Pencarian kode pos
Ubah satu kolom menjadi pencarian kode pos yang secara otomatis mengisi kolom Kota dan Negara Bagian/Wilayah Anda (termasuk yang tersembunyi) — ideal untuk formulir "periksa area Anda" dan perutean CRM.

Lompat ke Detail Fitur

Bagaimana cara mengaktifkan plugin ini?

Setelah membeli Address Autocomplete untuk Gravity Forms, Anda perlu melakukan hal berikut:

Instal plugin ini di situs web WordPress Anda.
Buat dan masukkan kunci API Google Anda.
Aktifkan Fitur Pelengkapan Otomatis pada Alamat atau Kolom teks satu baris.

Petunjuk di bawah ini akan menunjukkan cara menginstal plugin Anda, dan menghasilkan kunci API Google untuk Pelengkapan Otomatis Alamat serta mengaktifkannya pada kolom Alamat atau kolom teks Satu Baris.

Daftarkan Plugin dengan Plugin Brewery

Buat dan masukkan kunci API Google.

Sebelum dapat menggunakan Fitur Pelengkapan Alamat Otomatis, Anda perlu membuat kunci API di konsol Google Cloud Platform.

Aktifkan pada kolom Alamat

Aktifkan pada kolom Teks Satu Baris

Membuat Kunci API Google

Buat atau Pilih Proyek Google Cloud yang Sudah Ada

Sebelum Anda bisa mendapatkan kunci API Google, Anda perlu... buat yang baru Proyek Google Cloud Platform (atau pilih yang sudah ada jika Anda memilikinya).

Catatan: Jika Anda membuat proyek GCP baru, kami sarankan Anda membatasi cakupannya untuk situs web yang sedang Anda kerjakan, untuk berjaga-jaga jika Anda memerlukan layanan API Google lainnya untuk situs web yang sama.

Aktifkan API yang Diperlukan

Setelah Anda membuat atau memilih proyek Google Cloud, navigasikan ke API & Layanan > Pustaka API dan aktifkan API berikut:

Catatan: Google memerlukan akun penagihan yang terhubung ke proyek Anda sebelum mengaktifkan API Places. Untuk sebagian besar situs, penggunaannya termasuk dalam paket gratis Google, tetapi metode pembayaran tetap diperlukan.

API Tempat (Baru)

Tautan Cepat

Anda mungkin melihat “Places API” dan “Places API (New)” – Plugin kami dirancang agar kompatibel dengan “Places API (New)”.”

API Javascript Peta

Tautan Cepat

Hasilkan Kunci

Sekarang setelah Anda mengaktifkan kedua API di dalam proyek Anda, Anda dapat membuat Kunci API Anda.

Pergi ke API & Layanan > Kredensial, lalu klik “+ Buat Kredensial” dan terakhir klik “Kunci API”

Jendela dialog samping akan muncul di mana Anda dapat memberi nama tombol Anda.

Pada tahap ini, Anda dapat menggulir ke bawah dan mengklik "Buat", dan kunci Anda akan langsung dibuat, NAMUN... Anda harus menetapkan pembatasan pada kunci tersebut di langkah selanjutnya untuk mencegah penggunaan kunci Anda tanpa izin.

Catatan: Ini sangat penting! Kunci dapat dilihat sehingga Anda tidak ingin pihak yang tidak bertanggung jawab mencuri penggunaan gratis Anda.

Lanjutkan menggulir ke “Pembatasan aplikasi” di jendela dialog.

Di bawah “Pembatasan aplikasi” pilih “Situs web”

Di bawah “Pembatasan situs web”, tambahkan situs web Anda tempat kunci API harus digunakan. Jangan tambahkan https.

Kami menyarankan untuk menambahkan domain wildcard agar kunci tersebut berfungsi pada domain www dan non-www seperti ini: *.example-website.com/*

Klik buat dan kunci Anda akan muncul selanjutnya.

Sekarang kunci API Anda telah dibuat! Salin kunci tersebut, lalu tempelkan ke pengaturan Pelengkapan Alamat Otomatis pada plugin, dan Anda siap!

Pemformatan domain: Masukkan setiap domain pada barisnya masing-masing menggunakan format berikut: example.com/* - TIDAK https://, tidak ada garis miring di akhir domain itu sendiri, tetapi menyertakan /* pada akhirnya untuk mengizinkan semua halaman. Untuk mencakup semua subdomain (seperti www), tambahkan entri terpisah sebagai *.example.com/*. Untuk pengembangan lokal, gunakan localhost atau localhost:3000/* tergantung pada pengaturan Anda.

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

Persyaratan Layanan & Kebijakan Privasi Google

Fitur Plugin Brewery Address Autocomplete mengirimkan data formulir ke layanan Google untuk mendukung pencarian alamat. Sesuai pedoman Google, setiap aplikasi yang menggunakan Places API harus menampilkan tautan ke Google. Syarat dan Ketentuan Layanan serta Kebijakan Privasi.

Tergantung pada negara atau wilayah Anda, Anda mungkin juga diharuskan untuk mendapatkan persetujuan pengguna sebelum mengumpulkan data lokasi.

Detail Fitur

Jenis Bidang yang Didukung

Berfungsi pada kedua tipe bidang Gravity Forms:

Kolom alamat (input ganda)
Teks Satu Baris (input alamat satu baris)

Gunakan kolom Alamat jika Anda menginginkan subkolom alamat GF asli, atau Teks Satu Baris jika Anda menginginkan tata letak formulir yang lebih sederhana.

Pemetaan Alamat yang Diuraikan (Baru)

Petakan komponen alamat yang dipilih ke dalam kolom khusus di formulir Anda:

Baris Alamat 1
Baris Alamat 2
Kode Pos / ZIP
Kota/Daerah
Negara Bagian / Provinsi / Wilayah
Negara

Sangat cocok untuk kolom tersembunyi yang digunakan dalam pengecekan zona pengiriman, perutean CRM, pemberitahuan bersyarat, dan otomatisasi.

Pencarian Kode Pos (Baru)

Ubah kolom Teks Satu Baris menjadi pencarian kode pos/ZIP. Aktifkan Pelengkapan Otomatis Alamat, lalu aktifkan Pencarian Kode Pos di pengaturan Lanjutan kolom tersebut.

Saran terbatas pada kode pos/ZIP.
Kolom tersebut hanya menyimpan kode yang dipilih (bukan alamat lengkap).
Kota, Negara Bagian/Wilayah (dan Negara/Kabupaten jika dipetakan) terisi secara otomatis, termasuk ke dalam kolom tersembunyi.
Berlaku untuk negara mana pun yang memiliki kode pos.

Sangat cocok untuk pengecekan area layanan, logika pengiriman, dan pengiriman data lokasi yang akurat ke CRM Anda.

Teks Satu Baris untuk Penanganan Pos/Kode Pos

Untuk kolom Teks Satu Baris, plugin menggunakan format alamat Google dan menambahkan kode pos/ZIP jika tersedia tetapi tidak ada dalam teks yang ditampilkan. Jika Google tidak mengembalikan kode pos untuk suatu hasil, maka kode pos tidak dapat ditambahkan.

Metadata Tersimpan ke Meta Entri

Saat pengguna memilih saran, plugin akan menyimpan:

ID Tempat
Lintang
Garis bujur
Alamat yang Diformat

Pembatasan Negara + Dukungan Internasional

Anda dapat membatasi saran ke negara-negara tertentu dengan kode ISO alpha-2 (misalnya: US,CA,GB), atau biarkan tidak terbatas untuk formulir global.

Label dan opsi pemetaan bersifat netral terhadap negara, sehingga alur kerja tetap jelas bagi tim AS dan non-AS.

Performa + Kompatibilitas

Dirancang untuk lokasi produksi di dunia nyata:

Skrip front-end hanya diinisialisasi jika kolom yang diaktifkan ada.
Kompatibel dengan alur Gravity Forms standar dan AJAX.
Kompatibel dengan pengaturan caching/CDN umum di sebagian besar konfigurasi.

Tag Gabungan

Saat pengunjung memilih saran pelengkapan otomatis, plugin dapat menyimpan metadata pada entri tersebut. Anda dapat menyisipkan data tersebut dalam konfirmasi, pemberitahuan, dan tempat lain yang mendukung tag gabungan Gravity Forms.

Format: {pb_aac:ID:KEY}

Ganti ID dengan ID kolom Alamat atau Teks Satu Baris yang mengaktifkan Pelengkapan Otomatis Alamat (kolom yang sama tempat saran muncul).

Kunci yang tersedia (KEY):

KUNCI	Apa yang dihasilkannya?
`place_id`	ID Tempat Google
`lat`	Lintang
`lng`	Garis bujur
`formatted`	Alamat yang diformat (string yang diformat oleh Google)
`google_maps_url`	URL pencarian Google Maps yang dibuat dari ID Tempat (atau lintang/bujur jika ID Tempat tidak ada)

Contoh (jika kolom pelengkap otomatis Anda adalah kolom 12):

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

Pemilih: Di editor formulir, kolom yang diaktifkan juga mendapatkan tag ini di pemilih tag gabungan di bawah label seperti “Pelengkapan Otomatis Alamat: …”.

Catatan: Nilai hanya ada untuk entri di mana saran dipilih dan metadata disimpan; jika tidak, tag akan kosong (sesuai desain).

FAQ

Apakah Google Places API gratis?

Google secara otomatis memberikan kredit bulanan sebesar $200 ke akun Anda, yang akan digunakan untuk penagihan penggunaan API Places Anda. Untuk sebagian besar situs, ini mencakup semua biaya — dengan tarif saat ini, sekitar 10.000 sesi pelengkapan otomatis per bulan termasuk dalam kredit tersebut.

Namun, harga dapat berubah, jadi periksa kembali. Tabel Harga Platform Google Maps untuk angka terbaru.

Bisakah saya menggunakannya dengan kolom "Teks Satu Baris"?

Ya! Selain kolom Alamat standar, Anda dapat mengaktifkan fitur pelengkapan otomatis pada kolom Teks Satu Baris mana pun. Ideal untuk formulir yang hanya membutuhkan satu input alamat.

Apakah ini berlaku untuk alamat internasional?

Tentu saja. Plugin ini mendukung data alamat global dari Google.

Apakah pengaturannya rumit?

Tidak sama sekali. Cukup tambahkan kunci API Google Anda di pengaturan plugin, aktifkan fitur pelengkapan otomatis pada kolom yang Anda pilih, dan selesai. Semudah itu.

Bisakah saya membatasi hasil pencarian ke negara-negara tertentu?

Ya. Pada pengaturan kolom, berikan daftar kode negara ISO 3166-1 alpha-2 yang dipisahkan koma (misalnya, US,CA,GB).

API Places mana yang perlu saya aktifkan di Google Cloud?

Aktifkan “Places API (Baru)” karena “Places API” versi lama dijadwalkan akan dihentikan dan juga “Maps JavaScript API”.

Bisakah saya menggunakan metadata alamat dalam notifikasi atau integrasi?

Ya. Fitur Pelengkapan Otomatis Alamat menambahkan tag gabungan untuk ID Tempat, lintang, bujur, alamat yang diformat, dan URL Google Maps. Gunakan pemilih tag gabungan Gravity Forms di setiap notifikasi, konfirmasi, atau pemetaan umpan.

Bisakah pengembang menyesuaikan apa yang dikembalikan oleh Google?

Ya. Gunakan pb_aac_request Filter JavaScript untuk menyesuaikan permintaan — misalnya, memfokuskan hasil ke suatu wilayah, menambahkan kotak pembatas, atau memperluas cakupan untuk mencakup bisnis.

Bisakah saya menggunakan sebuah kolom sebagai pencarian kode pos?

Ya. Pada kolom Teks Satu Baris, aktifkan Pelengkapan Otomatis Alamat, lalu aktifkan Pencarian Kode Pos. Kolom tersebut menampilkan saran kode pos, dan memilih salah satunya akan mengisi kolom Kota dan Negara Bagian/Wilayah yang Anda pilih (termasuk yang tersembunyi). Sangat cocok untuk formulir bergaya "periksa area Anda" dan perutean CRM.

	Masuk ke situs web WordPress Anda dan navigasikan ke Plugin > Tambah Plugin > Unggah Plugin > Instal file zip dan aktifkan. Setelah diaktifkan, plugin akan muncul di Formulir > Pengaya > Terinstal dan pengaturannya berada di bawah Formulir > Pengaturan > Pelengkapan Otomatis Alamat.
	Di navigasi sebelah kiri, buka Formulir > Pengaturan > Pelengkapan Otomatis Alamat > Lisensi. Masukkan kunci lisensi Anda dan aktifkan. Selanjutnya, lanjutkan ke pengaturan pembuatan kunci API Google di bawah ini.