Ringkasan Address Validation

Developer Wilayah Ekonomi Eropa (EEA)

Mengapa menggunakan Validasi Alamat di Maps JavaScript API?

Library Validasi Alamat menggunakan alamat sebagai input untuk mengidentifikasi dan memvalidasi komponen alamat. 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™).

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 salah dan mendapatkan pemahaman yang lebih baik tentang karakteristik alamat.

Yang dapat Anda lakukan dengan Validasi Alamat di Maps JavaScript API

Dengan Validasi Alamat di Maps JavaScript API, Anda dapat menentukan apakah suatu alamat merujuk ke tempat yang sebenarnya. Jika alamat tidak merujuk ke tempat yang sebenarnya, API dapat mengidentifikasi komponen yang mungkin salah yang dapat Anda tunjukkan kepada pelanggan untuk dikoreksi. Berikut adalah contoh alur kerja:

  1. Pelanggan memasukkan alamat — Gambar berikut menampilkan formulir dasar yang memungkinkan pelanggan memasukkan alamat, mungkin sebagai bagian dari alur checkout.

    Alamat yang dimasukkan oleh pelanggan.

  2. Aplikasi mengirim alamat ke API — Aplikasi meneruskan alamat ini menggunakan metode fetchAddressValidation.

  3. API memvalidasi dan menstandardisasi alamat — Dalam responsnya, Address Validation API menampilkan alamat lengkap sebagaimana ditentukan oleh API, atau menunjukkan tempat informasi tidak ada.

  4. Pelanggan mengonfirmasi atau mengoreksi alamat — Bergantung pada apa yang ditampilkan API, Anda dapat memberikan perintah berikut kepada pelanggan:

    1. Konfirmasi alamat yang direkomendasikan.
    2. Berikan informasi yang belum ada.
    3. Perbaiki alamat.
    Pelanggan dapat mengonfirmasi alamat yang telah dikoreksi. Pelanggan dapat memberikan informasi yang kurang. Pelanggan dapat memperbaiki alamat.

Cara kerja Validasi Alamat di Maps JavaScript API

Saat panggilan ke fetchAddressValidation dilakukan, API akan mencoba hal berikut:

  • Memperbaiki — Menyediakan pemeriksaan validasi tingkat komponen, termasuk sub-tempat jika tersedia.
  • Selesai — Berupaya menyimpulkan komponen alamat yang tidak ada atau salah.
  • Format — Membersihkan dan menstandardisasi format untuk komponen alamat.

Tentang CASS™

United States Postal Service® (USPS®)1 mengelola Coding Accuracy Support System (CASS™) untuk mendukung dan mensertifikasi penyedia validasi alamat. Layanan Bersertifikasi CASS™, seperti Address Validation API, telah dikonfirmasi kemampuannya untuk melengkapi informasi yang tidak ada dalam alamat, menstandarkannya, dan memperbaruinya untuk memberi Anda alamat yang paling terbaru dan paling akurat.

CASS tidak diaktifkan secara default dan hanya didukung untuk wilayah "Amerika Serikat" dan "Puerto Riko". 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 pelanggan dan harus melaporkan informasi kontak pelanggan (nama dan alamat), alamat input yang relevan, dan data penggunaan gabungan kepada USPS. Dengan menggunakan API ini, Anda menyetujui Persyaratan Khusus Layanan.

Langkah berikutnya

  1. 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™. ↩