Ringkasan Address Validation API

Address Validation API adalah layanan yang menerima alamat. Alat ini mengidentifikasi komponen alamat dan memvalidasinya. File ini juga menstandarkan alamat untuk pengiriman surat dan menemukan koordinat lintang/bujur yang paling diketahui untuk alamat tersebut. 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 prediktabilitas pengiriman dan mengurangi kegagalan pengiriman, sehingga memberikan pengalaman pelanggan yang lebih baik. Anda melakukannya dengan menangkap alamat yang buruk dan mendapatkan pemahaman yang lebih baik tentang karakteristik alamat.

Geocoding API mungkin lebih cocok untuk kebutuhan Anda jika Anda tidak perlu memvalidasi komponen alamat individual. Geocoding API mengonversi alamat menjadi koordinat lintang/bujur, sedangkan Address Validation API memvalidasi alamat agar akurat. Lihat Membangun kemampuan validasi lokasi menggunakan Google Maps Platform di Pusat Arsitektur untuk mengetahui perbandingan mendetail.

Yang dapat Anda lakukan dengan Address Validation API

Dengan Address Validation API, Anda dapat menentukan apakah alamat merujuk ke tempat sungguhan. Jika alamat tidak merujuk ke tempat sebenarnya, API dapat mengidentifikasi komponen yang mungkin salah dan dapat Anda tunjukkan kepada pelanggan untuk diperbaiki. Berikut adalah contoh alur kerja menggunakan API:

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

2. Aplikasi mengirim 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 apa yang ditampilkan API, Anda dapat memberikan perintah berikut kepada pelanggan:

   • Tunjukkan alamat yang direkomendasikan kepada pelanggan untuk dikonfirmasi:
     

   • Minta pelanggan untuk menambahkan informasi yang belum 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. Fitur ini memisahkan alamat ke dalam komponen individualnya, lalu melakukan pemeriksaan dan koreksi berikut:

• Benar—Menyediakan pemeriksaan validasi tingkat komponen, termasuk sub-tempat jika tersedia.
• Lengkap—Mencoba untuk menyimpulkan komponen alamat yang tidak ada atau salah.
• Format dengan baik—Membersihkan dan menstandarkan format untuk komponen alamat.

Coba demo untuk melihat cara kerja Address Validation API.

Referensi

Tabel berikut meringkas resource yang tersedia melalui Address Validation API beserta data yang ditampilkan. Untuk mengetahui detail tertentu, lihat referensi Address Validation API.

Resource data	Data yang dikembalikan
Komponen alamat dalam format JSON. Lihat Memvalidasi alamat.	Alamat lengkap dan tervalidasi (jika memungkinkan). Status validasi setiap komponen alamat. Jika tersedia untuk alamat: Geocode Presisi alamat Data layanan pos, jika tersedia. Lihat Memahami respons validasi.

Cara menggunakan Address Validation API

1	Coba demo	Jelajahi demo dengan berbagai formulir alamat, baik yang benar maupun salah. Demo ini memberikan cara yang berguna untuk mempelajari nilai yang ditampilkan dari layanan, serta respons API berformat JSON.
2	Periksa cakupan	Tinjau detail cakupan untuk melihat negara dan wilayah yang didukung Address Validation API.
3	Melakukan penyiapan	Mulailah dengan Menyiapkan project Google Cloud Anda dan selesaikan petunjuk yang mengikutinya.
4	Meminta validasi alamat	Mulailah dengan alamat sederhana, lalu, untuk akurasi tambahan, Anda dapat mengaktifkan CASS (khusus 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 berbeda. Lihat Memahami respons dasar.
6	Meningkatkan akurasi validasi	Anda dapat membantu meningkatkan akurasi alamat dengan memberikan masukan tentang respons Address Validation API. Baca bagian Menangani alamat yang diperbarui.

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®)¹ mengelola Coding Akurasi Support System (CASSTM) untuk mendukung dan memberikan sertifikasi pada penyedia validasi alamat. Layanan CASS CertifiedTM, seperti Address Validation API, telah dikonfirmasi karena 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 lebih lanjut, lihat bagian Memvalidasi alamat.

Sebagai bagian dari penggunaan kami atas layanan USPS, USPS mengevaluasi permintaan untuk alamat yang dibuat secara artifisial. Jika USPS mengidentifikasi alamat input sebagai buatan, Google wajib 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 mengizinkan Persyaratan Spesifik Per Layanan ini.

Langkah selanjutnya

• 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