Menangani alamat di Amerika Serikat

Dokumen ini mencakup 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 dari hasil.

Karena objek ini tidak selalu terisi, Anda tidak boleh bergantung pada sebagai satu-satunya cara untuk memvalidasi alamat, tetapi alih-alih menerapkan komponen alamat dan verdict ke dalam sistem Anda.

Verifikasi Titik Pengiriman USPS (DPV)

Sebagai bagian dari respons uspsData, kolom dpvConfirmation menampilkan satu untuk memberi tahu Anda apakah USPS dapat mengirimkan ke alamat yang diberikan.

Anda dapat menggunakan kolom ini untuk menentukan hal berikut:

  • validitas alamat.
  • jika nomor sub-premis hilang dari alamat.
  • jika nomor sub-premis tidak ada dalam sistem data USPS.

Layanan ini menampilkan salah satu dari empat nilai dpvConfirmation atau tidak menampilkan nilai dpvConfirmation sama sekali. Tabel di bawah ini menunjukkan rekomendasi perilaku yang harus digunakan logika Anda untuk masing-masing dari 5 kemungkinan hasil. Untuk selengkapnya detail tentang logika ini, lihat Ringkasan alur kerja di Menggunakan respons validasi.

Nilai

Perilaku

Deskripsi

T atau kosong

Perbaiki alamat

Alamat tidak dikonfirmasi DPV.

Artinya USPS tidak mengenali nomor premis yang dimasukkan ada di jalan yang dimasukkan (rute), dan tidak dapat mengirim ke sana.

D

Perbaiki alamat

Alamat DPV dikonfirmasi hanya untuk nomor utama, dan informasi nomor sekunder hilang.

Ini berarti bahwa premis tersebut nomor yang dimasukkan ada di jalan yang dimasukkan, tetapi untuk mencapai terverifikasi/alamat pengiriman, nomor sub-premis yang valid juga harus yang Anda berikan. Dengan kata lain, sub-premis hilang dari input.

S

Konfirmasikan alamat

Alamat DPV dikonfirmasi hanya untuk nomor utama, dan ada informasi nomor sekunder tetapi tidak dikonfirmasi.

Ini berarti bahwa nomor premis yang dimasukkan ada di rute yang dimasukkan, tapi sub-premis yang disediakan tidak ada di dalam gedung itu, menurut ke USPS.

Y

Setujui alamat

Alamat merupakan DPV yang dikonfirmasi untuk nomor primer dan sekunder.

Ini berarti alamat dapat sepenuhnya dikirim oleh USPS, termasuk nomor sub-premis, jika berlaku.

Bagian selanjutnya membahas skenario dunia nyata yang menggunakan kode DPV.

Contoh DPV N - memperbaiki alamat

Contoh ini menggunakan nomor jalan yang tidak ada pada alamat yang valid.

  • Alamat yang dimasukkan: 12 Amphitheatre Parkway, Mountain View, CA, 94043
  • Region: Amerika Serikat
  • Kolom dpvConfirmation menampilkan: N

Ini merupakan sinyal yang sangat kuat bahwa nomor lokasi ini tidak ada pada rute ini. Seperti alamat bermasalah lainnya, sistem Anda akan meminta pengguna untuk dikoreksi.

Contoh DPV D - memperbaiki alamat

Contoh ini menggunakan kantor Google di New York, tetapi tidak berisi sub-premis yang merupakan bagian wajib dari alamat. Anda dapat melihatnya dengan menggunakan alamat di demo tanpa informasi sub-premis.

  • Alamat yang dimasukkan: 111 8th Avenue, New York, NY, 10011
  • Region: Amerika Serikat
  • Kolom dpvConfirmation menampilkan: D

Ini mengonfirmasi bahwa subpremis tidak ada dalam input. Untuk mendapatkan DPV dari Y, sub-premis yang valid harus disertakan sebagai bagian dari input. Misalnya, Anda dapat menyertakan sub-premis valid FL 4 (Lantai 4) untuk mendapatkan Nilai dpvConfirmation dari Y.

Contoh DPV S - konfirmasi alamat

Contoh ini menggunakan nomor sub-premis yang tidak ada di dalam gedung:

  • Alamat yang dimasukkan: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94.043
  • Region: Amerika Serikat
  • Kolom dpvConfirmation menampilkan: S

Ini menunjukkan bahwa, meskipun 1600 Amphitheatre Parkway ada sebagai alamat yang dapat menerima email, sub-premis Ste 101 bukan bagian dari alamat yang valid. Sistem Anda harus mengonfirmasi informasi ini dengan pengguna dan memberikan peluang untuk dikoreksi.

Contoh DPV Y - menerima alamat

Contoh ini menggunakan alamat Googleplex di Mountain View, CA sebagai alamat berkualitas yang diketahui.

  • Alamat yang dimasukkan: 1600 Amphitheatre Parkway, Mountain View, CA, 94043
  • Region: Amerika Serikat
  • Kolom dpvConfirmation menampilkan: Y

Alamat tersebut sepenuhnya dapat diberikan oleh USPS. Ini memberi Anda tingkat yang sangat tinggi dari keyakinan bahwa API menampilkan alamat yang berkualitas baik, dan Anda dapat menggunakannya sebagaimana yang diberikan.

Catatan: DPV tidak menunjukkan apakah Address Validation API telah membuat perubahan input, seperti koreksi ejaan.

Pesan keamanan untuk alamat di AS

Bagian ini membahas tanda keamanan yang disediakan dalam data USPS untuk alamat yang dibuat secara manipulatif. Langkah keamanan ini dirancang untuk mencegah pembuatan daftar alamat secara artifisial dengan mendeteksi kapan alamat yang dikirimkan tampaknya dibuat secara artifisial dan tidak diperoleh secara sah. Hal ini seharusnya sangat jarang terjadi.

Ketika USPS mengidentifikasi alamat yang dibuat palsu, errorMessage kolom properti uspsData pada respons berisi pesan error yang menjelaskan masalah. 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.