Alasan menggunakan Address Validation API
Dengan Address Validation API, Anda dapat meningkatkan prediktabilitas pengiriman dan mengurangi kegagalan pengiriman, sehingga dapat memberikan pengalaman pelanggan yang lebih baik. Anda melakukan hal ini dengan mendeteksi alamat yang buruk dan memperoleh pengetahuan yang lebih baik tentang karakteristik alamat.
Jika Anda tidak perlu memvalidasi masing-masing komponen alamat untuk permintaan Anda, Geocoding API mungkin lebih cocok dengan kebutuhan Anda. Geocoding API mengonversi alamat menjadi koordinat lintang/bujur, sedangkan Address Validation API memvalidasi alamat untuk ketepatan. Untuk mengetahui detailnya, lihat Cara kerja Address Validation API di bawah, serta ringkasan Geocoding API.
Yang dapat Anda lakukan dengan Address Validation API
Dengan Address Validation API, Anda dapat menentukan apakah alamat merujuk ke tempat sebenarnya. Jika alamat tidak merujuk ke tempat sebenarnya, API dapat mengidentifikasi komponen yang mungkin salah yang dapat Anda presentasikan kepada pelanggan untuk diperbaiki. Berikut adalah contoh alur kerja yang menggunakan API tersebut:
Pelanggan memasukkan alamat – Gambar berikut menunjukkan formulir sederhana yang memungkinkan pelanggan untuk memasukkan alamat, mungkin sebagai bagian dari alur checkout.
Aplikasi mengirim alamat ke API – Aplikasi meneruskan alamat ini sebagai input ke Address Validation API.
API memvalidasi dan menstandarkan alamat – Dalam responsnya, Address Validation API menampilkan alamat lengkap seperti yang ditentukan oleh API, atau menunjukkan jika ada informasi yang tidak ada.
Pelanggan mengoreksi atau mengonfirmasi alamat yang direkomendasikan – Bergantung pada informasi yang ditampilkan API, Anda dapat memberikan permintaan berikut kepada pelanggan:
Berikan alamat yang direkomendasikan kepada pelanggan untuk mengonfirmasi:
Minta pelanggan untuk menambahkan informasi yang tidak ada:
Minta pengguna untuk memperbaiki alamat jika API tidak dapat memvalidasi alamat input karena informasi tidak ada atau salah:
Cara kerja Address Validation API
Validasi alamat menerima permintaan POST dengan alamat dalam bentuk isi JSON. Kode ini memisahkan alamat menjadi komponennya masing-masing, lalu melakukan pemeriksaan dan koreksi berikut:
- Benar—Memberikan pemeriksaan validasi tingkat komponen, termasuk sub-premis jika tersedia.
- Selesai—Mencoba menyimpulkan komponen alamat yang tidak ada atau salah.
- Berformat dengan baik—Membersihkan dan menstandarkan format untuk komponen alamat.
Coba demo untuk melihat cara kerja Address Validation API.
Referensi
Tabel berikut merangkum resource yang tersedia melalui Address Validation API beserta data yang ditampilkannya. Untuk mengetahui detail spesifiknya, lihat Referensi API Validasi Alamat.
Resource data | Data yang ditampilkan |
---|---|
Komponen alamat dalam format JSON. Lihat Memvalidasi alamat. |
Alamat lengkap yang divalidasi (jika memungkinkan). Status validasi setiap komponen alamat. Jika tersedia untuk alamat:
Lihat Memahami respons validasi. |
Cara menggunakan Address Validation API
1 | Coba demonya | Pelajari demo dengan berbagai formulir alamat, baik yang benar maupun salah. Demo ini menyediakan cara yang bermanfaat untuk mempelajari nilai return dari layanan, serta respons API berformat JSON. |
2 | Periksa cakupan | Tinjau detail cakupan untuk melihat negara dan wilayah yang didukung Address Validation API. |
3 | Memulai persiapan | Mulailah dengan Menyiapkan project Google Cloud dan selesaikan petunjuk yang mengikuti. |
4 | Meminta validasi alamat | Mulailah dengan alamat sederhana, lalu agar lebih akurat, Anda dapat mengaktifkan CASS (hanya untuk alamat US dan PR). Lihat Meminta validasi alamat. |
5 | Memproses respons | Respons Address Validation API menyediakan dua properti, yang masing-masing Anda gunakan dengan cara yang berbeda. Lihat Memahami respons dasar. |
6 | Meningkatkan akurasi validasi | Anda dapat membantu meningkatkan akurasi alamat dengan memberikan masukan tentang respons Address Validation API. Lihat Memberikan masukan validasi alamat. |
Library klien yang tersedia
Untuk mengetahui daftar library klien yang tersedia untuk Address Validation API, lihat Library klien.
Tentang CASSTM
United States Postal Service® (USPS®)1 menggunakan Coding Accuracy Support System (CASSTM) untuk mendukung dan mensertifikasi penyedia validasi alamat. Layanan CASS CertifiedTM, seperti Address Validation API, telah dikonfirmasi kemampuannya untuk mengisi informasi yang hilang dari alamat, menstandarkannya, dan memperbaruinya untuk memberi Anda alamat terbaru dan paling akurat.
CASS tidak diaktifkan secara default dan hanya didukung untuk region "US" dan "PR". Untuk mengaktifkan CASS, tetapkan enableUspsCass
ke true
sebagai bagian dari permintaan validasi. Untuk mengetahui informasi selengkapnya, lihat
Memvalidasi alamat.
Sebagai bagian dari penggunaan kami atas layanan USPS, USPS mengevaluasi permintaan untuk alamat yang dibuat secara buatan. Jika USPS mengidentifikasi alamat input sebagai hasil buatan, Google diwajibkan untuk berhenti memvalidasi alamat untuk pelanggan dan harus melaporkan informasi kontak pelanggan (nama dan alamat), alamat input yang relevan, dan data penggunaan gabungan ke USPS. Dengan menggunakan API, Anda menyetujui Persyaratan Khusus Layanan ini.
Langkah berikutnya
- Meninjau FAQ: Buka FAQ
- Meninjau area cakupan: Buka Detail cakupan negara dan wilayah
- Memproses alamat dengan volume tinggi: Buka Menggunakan Address Validation API untuk memproses alamat dengan volume tinggi
-
Google Maps Platform adalah Penerima Lisensi non-eksklusif Amerika Serikat Postal Service®. Merek dagang berikut dimiliki oleh United States Postal Service® dan digunakan dengan izin: United States Postal Service®, CASSTM, CASS CertifiedTM. ↩