Ringkasan Address Validation API

Address Validation API adalah layanan yang menerima alamat, mengidentifikasi komponen alamat, dan memvalidasinya. Ini juga menstandarkan alamat untuk pengiriman dan menemukan lokasi lintang/bujur yang paling terkenal. Hal ini dapat membantu memahami apakah alamat mengacu pada tempat sebenarnya. Jika alamat tidak merujuk ke tempat sebenarnya, alamat tersebut dapat mengidentifikasi komponen yang mungkin salah, sehingga pengguna dapat mengoreksinya.

Address Validation API menyediakan banyak fitur untuk membantu Anda memproses alamat, termasuk:

  • Memisahkan alamat ke dalam masing-masing komponen, lalu menyediakan pemeriksaan validasi tingkat komponen, termasuk sub-lokalitas (jika tersedia).

  • Membersihkan, menstandarkan, dan menyimpulkan komponen alamat yang hilang atau salah.

  • Melengkapi alamat dengan informasi tambahan, termasuk geocode, presisi alamat, dan data layanan pos.

  • Menampilkan satu string yang berisi alamat lengkap seperti yang ditentukan oleh API.

Coba demo untuk melihat cara kerja Address Validation API.

Menambahkan Address Validation API ke alur kerja Anda

Salah satu kasus penggunaan paling umum dari Address Validation API adalah untuk meningkatkan pengalaman pelanggan Anda dengan memastikan bahwa pelanggan memberikan alamat yang benar. Validasi alamat membantu mengurangi kegagalan pengiriman dengan menangkap alamat yang buruk dan meningkatkan prediktabilitas pengiriman dengan pengetahuan yang lebih baik tentang karakteristik alamat.

Gambar berikut menunjukkan formulir sederhana yang memungkinkan pelanggan memasukkan alamat, mungkin sebagai bagian dari proses checkout. Teruskan alamat ini sebagai input ke Address Validation API.

Alamat yang dimasukkan oleh pelanggan.

Dalam responsnya, Address Validation API menampilkan alamat lengkap seperti yang ditentukan oleh API. Berikan alamat lengkap kepada pelanggan Anda sebagai alamat yang direkomendasikan:

Alamat seperti yang ditentukan oleh API.

Jika Address Validation API mendeteksi informasi yang tidak ada, minta pengguna untuk menambahkannya:

Formulir yang meminta pelanggan untuk memasukkan informasi alamat yang tidak ada.

Jika API tidak dapat memvalidasi alamat input karena informasi tidak ada atau salah, minta pengguna untuk memperbaiki alamat:

Formulir yang meminta pelanggan mengoreksi informasi alamat.

Perbedaan antara Address Validation API dan Geocoding API

Geocoding API dan API Validasi Alamat mencoba menjawab pertanyaan "di mana lokasi terbaik untuk input pengguna ini?" Tidak seperti Geocoding API, Address Validation API juga mencoba:

  • Jawab pertanyaan "Apakah input pengguna ini mewakili alamat sebenarnya?"
  • Pahami alamat input meskipun beberapa bagian tidak dapat dicocokkan dengan Data yang tersedia
  • Memberikan masukan tentang validitas berbagai komponen
  • Verifikasi apakah alamat lengkap dan tandai komponen yang diperlukan yang tidak ada
  • Memformat alamat pengembalian yang khusus untuk tujuan pengiriman email

Misalnya, dengan alamat seperti "123 Fake St, Mountain View, CA", Geocoding API hanya akan menampilkan geocode untuk kota Mountain View, CA dan mengabaikan "123 Fake St" karena tidak ada jalan tersebut (atau nama jalan yang sama) di Mountain View.

Di sisi lain, Address Validation API dapat mengidentifikasi bahwa "123" adalah nomor jalan, "Fake St" adalah jalan, dan menampilkan hasil yang berisi komponen tersebut dan menandainya sebagai belum dikonfirmasi, sehingga memberi Anda sinyal tentang mengapa alamat mungkin gagal di-geocoding.

Tentang CASSTM

United States postal Service® (USPS®)1 mempertahankan Sistem Dukungan Akurasi Coding (CASSTM) untuk mendukung dan mensertifikasi penyedia validasi alamat. Layanan CASS CertifiedTM, seperti Address Validation API, telah terkonfirmasi karena kemampuannya untuk mengisi informasi yang tidak ada dalam alamat, menstandarkannya, dan memperbaruinya untuk memberikan alamat yang paling baru dan akurat kepada Anda.

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 mendapatkan informasi lebih lanjut, lihat Memvalidasi alamat.

Sebagai bagian dari penggunaan layanan USPS, USPS mengevaluasi permintaan untuk alamat yang dibuat secara tidak semestinya. Jika USPS mengidentifikasi bahwa alamat input dibuat secara buatan, Google harus 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 ini, Anda menyetujui Persyaratan Khusus Layanan ini.

Langkah berikutnya

  1. Google Maps Platform adalah Penerima Lisensi non-eksklusif dari Amerika Serikat Pos Service®. Merek dagang berikut dimiliki oleh Amerika Serikat Pos Service® dan digunakan dengan izin: United States postal Service®, CASSTM, CASS CertifiedTM. ↩