Ringkasan Address Validation API

Address Validation API adalah layanan yang menerima alamat. Kode ini mengidentifikasi komponen alamat dan memvalidasinya. Ini juga menstandarkan alamat untuk pengiriman email dan menemukan koordinat lintang/bujur terbaik yang diketahui. Secara opsional, untuk alamat di Amerika Serikat dan Puerto Riko, Anda dapat mengaktifkan Sistem Dukungan Akurasi Coding (CASSTM).

Alasan menggunakan Address Validation API

Dengan Address Validation API, Anda dapat meningkatkan kemampuan prediksi pengiriman dan mengurangi kegagalan pengiriman, sehingga memberikan pengalaman pelanggan yang lebih baik. Anda melakukannya dengan menangkap alamat yang buruk dan mendapatkan kesadaran yang lebih baik tentang karakteristik alamat.

Jika Anda tidak perlu memvalidasi komponen alamat individual untuk permintaan Anda, Geocoding API mungkin lebih cocok untuk 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 mengacu pada tempat sebenarnya, API dapat mengidentifikasi kemungkinan komponen yang salah yang dapat Anda presentasikan kepada pelanggan untuk diperbaiki. Berikut contoh alur kerja yang menggunakan API:

1. Pelanggan memasukkan alamat – Gambar berikut menunjukkan formulir sederhana yang memungkinkan pelanggan memasukkan alamat, mungkin sebagai bagian dari alur checkout.
   

2. Aplikasi mengirimkan alamat ke API – Aplikasi meneruskan alamat ini sebagai input ke Address Validation API.

3. API memvalidasi dan menstandarkan alamat – Dalam responsnya, Address Validation API menampilkan alamat lengkap seperti yang ditentukan oleh API, atau menunjukkan tempat informasi tidak ada.

4. Pelanggan mengoreksi atau mengonfirmasi alamat yang direkomendasikan – Bergantung pada hal yang ditampilkan API, Anda dapat memberikan petunjuk berikut kepada pelanggan:

   • Berikan alamat yang direkomendasikan kepada pelanggan untuk dikonfirmasi:
     

   • Minta pelanggan untuk menambahkan informasi yang tidak ada:
     

   • Minta pengguna untuk memperbaiki alamat jika API tidak dapat memvalidasi alamat input karena informasi yang 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 komponen individualnya, lalu melakukan pemeriksaan dan koreksi berikut:

• Memberikan pemeriksaan validasi tingkat komponen, termasuk sub-lokalitas jika tersedia.
• Mencoba menyimpulkan komponen alamat yang hilang atau salah.
• Membersihkan dan menstandarkan format untuk komponen alamat.

Coba demonya untuk melihat cara kerja Address Validation API.

Resource

Tabel berikut merangkum resource yang tersedia melalui Address Validation API beserta data yang ditampilkan. Untuk mengetahui detail spesifik, lihat Referensi Address Validation API.

Resource data	Data yang ditampilkan
Mengatasi komponen dalam format JSON. Lihat Memvalidasi alamat.	Alamat lengkap yang divalidasi (jika memungkinkan). Status validasi setiap komponen alamat. Jika tersedia untuk alamat: Geocode Akurasi alamat Data layanan pos, jika tersedia. Lihat Memahami respons validasi.

Cara menggunakan Address Validation API

1	Coba demonya	Jelajahi demo dengan berbagai formulir alamat, baik yang benar maupun salah. Demo ini memberikan cara berguna untuk mempelajari nilai return dari layanan, serta respons API berformat JSON.
2	Mulai penyiapan.	Mulailah dengan Menyiapkan project Google Cloud Anda dan selesaikan petunjuk berikut.
3	Memvalidasi alamat	Mulai dengan alamat sederhana, lalu untuk akurasi tambahan, Anda dapat mengaktifkan CASS (khusus alamat AS dan PR). Lihat Memvalidasi alamat.
4	Memproses respons	Respons Address Validation API menyediakan dua properti, yang masing-masing akan Anda gunakan dengan cara berbeda. Lihat Memahami respons validasi.
5	Meningkatkan akurasi validasi	Anda dapat membantu kami meningkatkan akurasi alamat dengan memberikan masukan terkait 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®)¹ mempertahankan Coding Depth Support System (CASSTM) untuk mendukung dan memberikan sertifikasi kepada penyedia validasi alamat. Layanan CASS CertifiedTM, seperti Address Validation API, telah dikonfirmasi karena kemampuannya mengisi informasi yang tidak ada di alamat, menstandarkannya, dan mengupdatenya untuk memberikan alamat yang paling baru dan 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 bahwa alamat input dibuat secara buatan, Google diwajibkan untuk menghentikan validasi alamat pelanggan dan harus melaporkan informasi kontak pelanggan (nama dan alamat), alamat input yang relevan, dan data penggunaan gabungan kepada USPS. Dengan menggunakan API, Anda menyetujui Persyaratan Khusus Layanan ini.

Langkah berikutnya

• Tinjau 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