Menggunakan Address Validation API untuk memproses alamat dengan volume tinggi

Tujuan

Sebagai developer, Anda sering bekerja dengan set data yang berisi alamat pelanggan yang mungkin tidak berkualitas baik. Anda harus memastikan bahwa alamat sudah benar untuk kasus penggunaan, mulai dari verifikasi ID pelanggan, pengiriman, dan lainnya.

Address Validation API adalah produk dari Google Maps Platform yang dapat Anda gunakan untuk memvalidasi alamat. Namun, hanya memproses satu alamat pada satu waktu. Dalam dokumen ini, kita akan melihat cara menggunakan Validasi Alamat Volume Tinggi dalam berbagai skenario, mulai dari pengujian API hingga validasi alamat satu kali dan berulang.

Kasus penggunaan

Sekarang kita akan memahami kasus penggunaan saat Validasi Alamat Volume Tinggi berguna.

Pengujian

Anda sering kali ingin menguji Address Validation API dengan menjalankan ribuan alamat. Anda mungkin memiliki alamat dalam file Nilai yang Dipisahkan Koma dan ingin memvalidasi kualitas alamat tersebut.

Validasi alamat satu kali

Saat melakukan aktivasi ke Address Validation API, Anda ingin memvalidasi database alamat yang ada dengan database pengguna.

Validasi alamat berulang

Sejumlah skenario memerlukan validasi alamat secara berulang:

• Anda mungkin telah menjadwalkan tugas untuk memvalidasi alamat guna mengetahui detail yang diambil dalam sehari, misalnya dari pendaftaran pelanggan, detail pesanan, dan jadwal pengiriman.
• Anda mungkin menerima dump data yang berisi alamat dari berbagai departemen, misalnya, dari penjualan hingga pemasaran. Departemen baru yang menerima alamat tersebut sering kali ingin memvalidasinya sebelum digunakan.
• Anda dapat mengumpulkan alamat selama survei, atau berbagai promosi, lalu memperbaruinya di sistem online. Anda ingin memvalidasi alamat yang benar saat memasukkannya ke dalam sistem.

Pembahasan mendalam teknis

Untuk tujuan dokumen ini, kami mengasumsikan bahwa:

• Anda memanggil Address Validation API dengan alamat dari database pelanggan (yaitu database dengan detail pelanggan)
• Anda dapat meng-cache tanda validitas terhadap setiap alamat dalam database Anda.
• Flag validitas diambil dari Address Validation API saat setiap pelanggan login.

Coba sekarang: Buka konsol Google Cloud dan aktifkan Address Validation API.

Cache untuk penggunaan produksi

Catatan: Elemen respons tertentu yang dijelaskan di bagian berikut dapat disimpan selama maksimum 30 hari kalender berturut-turut. Semua elemen respons ini HARUS dihapus setelah batas 30 hari.

Saat menggunakan Address Validation API, Anda sering kali ingin meng-cache beberapa bagian respons dari panggilan API. Meskipun Persyaratan Layanan kami membatasi data yang dapat di-cache, data apa pun yang dapat di-cache dari Address Validation API harus di-cache ke akun pengguna. Artinya, di database, alamat, atau metadata alamat harus di-cache terhadap alamat email pengguna atau ID utama lainnya.

Untuk kasus penggunaan Validasi Alamat Volume Tinggi, penyimpanan dalam cache data harus mengikuti Persyaratan Khusus Layanan Address Validation API, yang diuraikan di Bagian 11.3. Berdasarkan informasi ini, Anda akan dapat menentukan apakah alamat pengguna mungkin tidak valid, dalam hal ini Anda akan meminta pengguna untuk memperbaiki alamat selama interaksi berikutnya dengan aplikasi Anda.

• Data dari objek AddressComponent
  • confirmationLevel
  • inferred
  • spellCorrected
  • replaced
  • unexpected

Jika Anda ingin meng-cache informasi apa pun tentang alamat sebenarnya, data tersebut hanya boleh di-cache dengan izin pengguna. Hal ini memastikan bahwa pengguna mengetahui dengan baik alasan layanan tertentu menyimpan alamat mereka dan mereka setuju dengan persyaratan berbagi alamat mereka.

Contoh izin pengguna adalah interaksi langsung dengan formulir alamat e-commerce di halaman checkout. Ada pemahaman bahwa Anda akan meng-cache dan memproses alamat untuk tujuan pengiriman paket.

Dengan izin pengguna, Anda dapat meng-cache formattedAddress dan komponen utama lainnya dari respons. Namun, dalam skenario headless, pengguna tidak dapat memberikan izin karena validasi alamat terjadi dari backend. Oleh karena itu, Anda dapat meng-cache informasi yang sangat terbatas dalam skenario headless ini.

Memahami respons

Catatan: Tersedia juga panduan bagus Membangun logika validasi yang menjelaskan cara menafsirkan respons.

Jika respons Address Validation API berisi penanda berikut, Anda dapat yakin bahwa alamat input memiliki kualitas yang dapat dikirim:

• Penanda addressComplete dalam objek Verdict adalah true,
• validationGranularity dalam objek Verdict adalah PREMISE atau SUB_PREMISE
• Tidak ada AddressComponent yang ditandai sebagai:
  • Inferred(Catatan: inferred=truedapat terjadi saat addressComplete=true)
  • spellCorrected
  • replaced
  • unexpected, dan
• confirmationLevel: Tingkat konfirmasi di AddressComponent disetel keCONFIRMEDatauUNCONFIRMED_BUT_PLAUSIBLE

Jika respons API tidak berisi penanda di atas, berarti alamat input kemungkinan berkualitas buruk, dan Anda dapat menyimpan flag dalam cache di database untuk mencerminkan hal tersebut. Tanda yang di-cache menunjukkan bahwa alamat secara keseluruhan memiliki kualitas yang buruk, sedangkan tanda yang lebih mendetail seperti Ejaan Diperbaiki menunjukkan jenis masalah kualitas alamat tertentu. Pada interaksi pelanggan berikutnya dengan alamat yang ditandai sebagai berkualitas buruk, Anda dapat memanggil Address Validation API dengan alamat yang ada. Address Validation API akan menampilkan alamat yang dikoreksi yang dapat Anda tampilkan menggunakan perintah UI. Setelah pelanggan menyetujui alamat yang diformat, Anda dapat meng-cache hal berikut dari respons:

• formattedAddress
• postalAddress
• addressComponent componentNamesatau
• UspsData standardizedAddress

Mengimplementasikan validasi Alamat headless

Catatan: Apa yang dimaksud dengan headless? Software yang dapat berfungsi di perangkat tanpa antarmuka pengguna grafis, seperti skrip yang dijalankan sisi server atau command line. Kita akan menggunakan istilah ini untuk menjelaskan saat software digunakan tanpa GUI.

Berdasarkan diskusi di atas:

• Sering kali Anda perlu menyimpan beberapa bagian respons dari Address Validation API ke dalam cache karena alasan bisnis.
• Namun, Persyaratan Layanan di Google Maps Platform membatasi data yang dapat di-cache.

Di bagian berikut, kita akan membahas proses dua langkah tentang cara mematuhi Persyaratan Layanan dan menerapkan validasi alamat bervolume tinggi.

Langkah 1:

Pada langkah pertama, kita akan mempelajari cara mengimplementasikan skrip validasi alamat bervolume tinggi dari pipeline data yang ada. Proses ini akan memungkinkan Anda menyimpan kolom tertentu dari respons Address Validation API dengan cara yang sesuai dengan Persyaratan Layanan.

Diagram A: Diagram berikut menunjukkan bagaimana pipeline data dapat ditingkatkan dengan logika Validasi Alamat Volume Tinggi.

Sesuai dengan Persyaratan Layanan, Anda dapat meng-cache data berikut dari addressComponent:

• confirmationLevel
• inferred
• spellCorrected
• replaced
• unexpected

Jadi, selama langkah implementasi ini, kita akan meng-cache kolom yang disebutkan di atas terhadap User-ID.

Untuk informasi selengkapnya, lihat detail tentang struktur data sebenarnya.

Langkah 2:

Pada langkah 1, kami mengumpulkan masukan bahwa beberapa alamat dalam set data input mungkin tidak berkualitas tinggi. Pada langkah berikutnya, kami akan mengambil alamat yang ditandai ini dan menampilkannya kepada pengguna serta mendapatkan izin mereka untuk memperbaiki alamat yang disimpan.

Diagram B: Diagram ini menunjukkan tampilan integrasi menyeluruh alur izin pengguna:

1. Saat pengguna login, periksa terlebih dahulu apakah Anda telah meng-cache tanda validasi apa pun di sistem Anda.
2. Jika ada tanda, Anda harus menunjukkan UI kepada pengguna untuk memperbaiki dan memperbarui alamat mereka.
3. Anda dapat memanggil Address Validation API lagi dengan alamat yang diperbarui atau disimpan dalam cache dan menampilkan alamat yang dikoreksi kepada pengguna untuk dikonfirmasi.
4. Jika alamat memiliki kualitas yang baik, Address Validation API akan menampilkan formattedAddress.
5. Anda dapat menampilkan alamat tersebut kepada pengguna jika koreksi telah dilakukan, atau menerimanya secara otomatis jika tidak ada koreksi.
6. Setelah pengguna menyetujui, Anda dapat meng-cache formattedAddress di database.

Catatan: Setelah alur kerja ini selesai, validationFlags yang di-cache harus dihapus.

Kesimpulan

Validasi Alamat Volume Tinggi adalah kasus penggunaan umum yang mungkin akan Anda temui di banyak aplikasi. Dokumen ini mencoba menunjukkan beberapa skenario dan pola desain tentang cara menerapkan solusi tersebut yang sesuai dengan Persyaratan layanan Google Maps Platform.

Kami telah menulis lebih lanjut implementasi referensi Validasi Alamat Volume Tinggi sebagai library open source di GitHub. Lihat panduan ini untuk mulai membangun solusi dengan Validasi Alamat Volume Tinggi (High Volume Address Validation). Buka juga artikel tentang pola desain cara menggunakan library dalam berbagai skenario.

Langkah Berikutnya

Download Whitepaper Meningkatkan checkout, pengiriman, dan operasi dengan alamat yang andal dan tonton Webinar Meningkatkan checkout, pengiriman, dan operasi dengan Validasi Alamat .

Bacaan lebih lanjut yang disarankan:

• Penerapan Validasi Alamat Bervolume Tinggi
• Library Python di github
• Jelajahi demo Address Validation

Kontributor

Google mengelola artikel ini. Kontributor berikut awalnya menulisnya.
Penulis utama:

Henrik Valve | Solutions Engineer
Thomas Anglaret | Solutions Engineer
Sarthak Ganguly | Solutions Engineer