Pengantar
Address Validation API adalah layanan yang menerima alamat. API ini mengidentifikasi komponen alamat dan memvalidasinya. Selain itu, Address Validation API menstandarkan alamat untuk pengiriman dan menemukan koordinat lintang/bujur yang paling akurat untuk alamat tersebut. Secara opsional, untuk alamat di Amerika Serikat dan Puerto Riko, Anda dapat mengaktifkan Coding Accuracy Support System (CASS™).Alasan menggunakan Address Validation API
Dengan Address Validation API, Anda dapat meningkatkan prediktabilitas pengiriman dan mengurangi kegagalan pengiriman, sehingga memberikan pengalaman pelanggan yang lebih baik. Anda dapat melakukannya dengan menangkap alamat yang salah dan mendapatkan pemahaman yang lebih baik tentang karakteristik alamat.
Pertimbangan lainnya
Address Validation API memvalidasi alamat untuk kebenaran. Geocoding API mengonversi alamat menjadi koordinat lintang dan bujur. Lihat Membangun kemampuan validasi lokasi menggunakan Google Maps Platform di Pusat Arsitektur untuk perbandingan mendetail.
Geocoding API mungkin lebih sesuai dengan kebutuhan Anda jika Anda tidak perlu memvalidasi komponen alamat satu per satu, atau jika Anda memerlukan detail tujuan hiper-lokal seperti pintu masuk gedung, garis luar gedung, dan titik navigasi.
Geocoding API v4 memperkenalkan metode SearchDestinations, yang menampilkan koordinat untuk pintu masuk gedung, titik navigasi, dan garis luar gedung.
Lihat bagian Menelusuri
tujuan
di Geocoding API v4 untuk mengetahui detail selengkapnya.
Yang dapat Anda lakukan dengan Address Validation API
Dengan Address Validation API, Anda dapat menentukan apakah alamat merujuk ke tempat yang sebenarnya. Jika alamat tidak merujuk ke tempat yang sebenarnya, API dapat mengidentifikasi komponen yang mungkin salah yang dapat Anda tampilkan kepada pelanggan untuk dikoreksi. Berikut adalah contoh alur kerja menggunakan API:
Pelanggan memasukkan alamat – Gambar berikut menampilkan formulir dasar yang memungkinkan pelanggan memasukkan alamat, mungkin sebagai bagian dari alur checkout.
Aplikasi mengirimkan 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 informasi yang tidak ada.
Pelanggan mengonfirmasi atau mengoreksi alamat – Bergantung pada hasil yang ditampilkan API, Anda dapat memberikan perintah berikut kepada pelanggan: A. Konfirmasi alamat yang direkomendasikan. B. Berikan informasi yang tidak ada. C. Perbaiki alamat.
Cara kerja Address Validation API
Validasi alamat menerima permintaan POST dengan alamat dalam bentuk isi JSON. Validasi alamat memisahkan alamat ke dalam komponennya masing-masing, lalu mencoba hal berikut:
- Mengoreksi—Menyediakan pemeriksaan validasi tingkat komponen, termasuk sub-lokasi jika tersedia.
- Melengkapi—Mencoba menyimpulkan komponen alamat yang tidak ada atau salah.
- Memformat—Membersihkan dan menstandarkan format untuk komponen alamat.
Resource
Tabel berikut merangkum resource yang tersedia melalui Address Validation API beserta data yang ditampilkan. Untuk detail spesifik, lihat referensi Address Validation API.
| 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 demo | Jelajahi demo dengan berbagai formulir alamat, baik yang benar maupun yang salah. Demo ini memberikan cara yang berguna untuk menjelajahi nilai yang ditampilkan dari layanan, serta respons API berformat JSON. |
| 2 | Periksa cakupan | Tinjau detail cakupan untuk melihat negara dan wilayah mana yang didukung oleh Address Validation API. |
| 3 | Siapkan | Mulai dengan Menyiapkan project Google Cloud dan selesaikan petunjuk yang mengikuti. |
| 4 | Minta validasi alamat | Mulai dengan alamat dasar, lalu, untuk akurasi tambahan, Anda dapat mengaktifkan CASS (hanya untuk alamat AS dan PR). Lihat Meminta validasi alamat. |
| 5 | Proses respons | Respons Address Validation API menyediakan dua properti, yang masing-masing Anda gunakan dengan cara yang berbeda. Lihat Memahami respons dasar. |
| 6 | Tingkatkan akurasi validasi | Anda dapat membantu meningkatkan akurasi alamat dengan memberikan masukan tentang Address Validation API responses. Lihat Menangani alamat yang diperbarui. |
Library klien yang tersedia
Untuk mengetahui daftar library klien yang tersedia untuk Address Validation API, lihat Library klien.
Tentang CASS™
United States Postal Service® (USPS®)1 mempertahankan Coding Accuracy Support System (CASS™) untuk mendukung dan mensertifikasi penyedia validasi alamat. Layanan CASS Certified™, seperti Address Validation API, telah dikonfirmasi kemampuannya untuk mengisi informasi yang tidak ada dari alamat, menstandarkannya, dan memperbaruinya untuk memberi Anda alamat yang paling baru dan paling akurat.
CASS tidak diaktifkan secara default dan hanya didukung untuk wilayah "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 layanan USPS, USPS mengevaluasi permintaan untuk alamat yang dibuat secara artifisial. Jika USPS mengidentifikasi alamat input sebagai alamat yang dibuat secara artifisial, 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
- Coba demo: Buka Demo
- Tinjau area cakupan: Buka Detail cakupan negara dan wilayah
- Coba permintaan validasi pertama Anda: Buka Mengirim permintaan validasi alamat
- Proses alamat dalam volume tinggi: Buka Menggunakan Address Validation API untuk memproses alamat dalam volume tinggi
-
Google Maps Platform adalah Penerima Lisensi non-eksklusif dari United States Postal Service®. Merek dagang berikut dimiliki oleh United States Postal Service® dan digunakan dengan izin: United States Postal Service®, CASS™, CASS Certified™. ↩