Dokumen ini membahas validasi alamat khusus untuk Amerika Serikat:
Data USPS dalam alur kerja Anda
Saat memvalidasi alamat di Amerika Serikat, layanan Address Validation API juga dapat mengisi bagian uspsData yang ditampilkan.
Karena objek ini tidak selalu diisi, Anda tidak boleh mengandalkan properti ini sebagai satu-satunya cara untuk memvalidasi alamat, tetapi sertakan juga komponen alamat dan verdict ke dalam sistem Anda.
Verifikasi Titik Pengiriman (DPV) USPS
Sebagai bagian dari respons uspsData
, kolom dpvConfirmation
menampilkan satu
karakter untuk memberi tahu Anda apakah USPS dapat mengirim ke alamat yang diberikan.
Anda dapat menggunakan kolom ini untuk menentukan hal berikut:
- validitas alamat email.
- jika nomor sub-premis tidak ada di alamat.
- jika nomor sub-premis tidak ada dalam sistem data USPS.
Layanan menampilkan salah satu dari empat nilai dpvConfirmation
atau tidak
menampilkan nilai dpvConfirmation
sama sekali. Tabel di bawah menampilkan rekomendasi perilaku yang harus digunakan logika untuk masing-masing dari 5 kemungkinan hasil. Untuk detail
selengkapnya tentang logika ini, lihat
Ringkasan alur kerja di Menggunakan respons validasi.
Nilai |
Perilaku |
Deskripsi |
---|---|---|
T atau kosong |
Perbaiki alamat |
Alamat tidak dikonfirmasi oleh DPV. Artinya, USPS tidak mengenali nomor premis yang dimasukkan yang ada di jalan yang dimasukkan (rute), dan tidak dapat mengirim ke sana. |
D |
Perbaiki alamat |
Alamat tersebut dikonfirmasi oleh DPV hanya untuk nomor utama, dan
informasi nomor sekunder tidak ada. |
S |
Konfirmasikan alamat |
Alamatnya dikonfirmasi oleh DPV hanya untuk nomor utama, dan ada informasi nomor sekunder, tetapi tidak dikonfirmasi. Artinya, nomor premis yang dimasukkan ada di rute yang dimasukkan, tetapi sub-premis yang disediakan tidak ada di dalam bangunan itu, menurut USPS. |
Y |
Setujui alamat |
Alamat tersebut telah dikonfirmasi DPV untuk nomor utama dan sekunder apa pun. Hal ini berarti alamat dapat dikirim sepenuhnya oleh USPS, termasuk nomor sub-premis, jika ada. |
Bagian selanjutnya dari artikel ini akan membahas skenario dunia nyata yang menggunakan kode DPV.
Contoh DPV N - memperbaiki alamat
Contoh ini menggunakan nomor jalan yang tidak ada di alamat yang valid.
- Alamat yang dimasukkan: 12 Amphitheatre Parkway, Mountain View, CA, 94043
- Wilayah: Amerika Serikat
- Kolom
dpvConfirmation
menampilkan:N
Ini adalah sinyal yang sangat kuat bahwa nomor premis ini tidak ada di rute ini. Seperti alamat bermasalah lainnya, sistem Anda harus meminta koreksi pengguna.
Contoh DPV D - memperbaiki alamat
Contoh ini menggunakan kantor Google di New York, tetapi tidak berisi sub-premis yang merupakan bagian alamat yang diperlukan. Anda dapat melihatnya menggunakan alamat di demo tanpa informasi sub-premis.
- Alamat yang dimasukkan: 111 8th Avenue, New York, NY, 10011
- Wilayah: Amerika Serikat
- Kolom
dpvConfirmation
menampilkan:D
Hal ini mengonfirmasi bahwa sub-premis tidak ada di input. Untuk mencapai DPV Y, sub-premis yang valid harus disertakan sebagai bagian dari input. Misalnya,
Anda dapat menyertakan subpremis FL 4 (Lantai 4) yang valid untuk mendapatkan
nilai dpvConfirmation
Y.
Contoh DPV S - mengonfirmasi alamat
Contoh ini menggunakan nomor subpremis yang tidak ada di dalam gedung:
- Alamat yang dimasukkan: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
- Wilayah: Amerika Serikat
- Kolom
dpvConfirmation
menampilkan:S
Hal ini menunjukkan bahwa, meskipun 1600 Amphitheatre Parkway ada sebagai alamat yang dapat menerima email, Ste 101 sub-premis bukan merupakan bagian dari alamat tersebut yang valid. Sistem Anda harus mengonfirmasi informasi ini dengan pengguna dan memberikan peluang untuk koreksi.
Contoh DPV Y - menerima alamat
Contoh ini menggunakan alamat Googleplex di Mountain View, CA sebagai alamat kualitas yang diketahui.
- Alamat yang dimasukkan: 1600 Amphitheatre Parkway, Mountain View, CA, 94043
- Wilayah: Amerika Serikat
- Kolom
dpvConfirmation
menampilkan:Y
Alamat dapat dikirim sepenuhnya oleh USPS. Hal ini memberi Anda tingkat keyakinan yang sangat tinggi bahwa API tersebut menampilkan alamat dengan kualitas yang baik, dan Anda dapat menggunakannya sebagaimana mestinya.
Catatan: DPV tidak menunjukkan apakah Address Validation API telah melakukan perubahan pada input, seperti koreksi ejaan.
Pesan keamanan untuk alamat di Amerika Serikat
Bagian ini membahas flag keamanan yang diberikan dalam data USPS untuk alamat yang dibuat secara artifisial. Langkah keamanan ini dirancang untuk mencegah pembuatan daftar alamat secara buatan dengan mendeteksi saat alamat yang dikirim tampaknya dibuat secara artifisial dan tidak diperoleh secara sah. Hal ini akan sangat jarang terjadi.
Saat USPS mengidentifikasi alamat yang dibuat secara artifisial, kolom errorMessage
di properti uspsData pada respons akan berisi pesan error yang menjelaskan masalah tersebut. Contoh:
AMS API processing was terminated due to the detection of what is determined to
be an artificially created address. No address beyond this point has been
validated and/or processed. If you believe this address was identified in error,
please contact your Vendor.