Menangani alamat di Amerika Serikat

Dokumen ini membahas validasi alamat khusus untuk Amerika Serikat:

Data USPS dalam alur kerja Anda

Saat memvalidasi alamat di Amerika Serikat, Address Validation API juga dapat mengisi bagian uspsData dari hasil.

Karena objek ini tidak selalu terisi, Anda tidak boleh mengandalkan properti ini sebagai satu-satunya cara untuk memvalidasi alamat, tetapi juga menggabungkan komponen putusan dan alamat 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 mengirimkan ke alamat yang diberikan.

Anda dapat menggunakan kolom ini untuk menentukan hal berikut:

  • validitas alamat.
  • apakah nomor sub-lokasi tidak ada di alamat.
  • apakah nomor sub-lokasi 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 menunjukkan perilaku yang direkomendasikan yang harus digunakan logika Anda untuk setiap dari 5 kemungkinan hasil. Untuk mengetahui detail selengkapnya tentang logika ini, lihat Ringkasan alur kerja di Membuat logika validasi Anda.

Nilai

Perilaku

Deskripsi

T

atau kosong

Memperbaiki alamat

Alamat tidak dikonfirmasi DPV.

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

D

Memperbaiki alamat

Alamat dikonfirmasi DPV hanya untuk nomor utama, dan informasi nomor sekunder tidak ada.
Artinya, nomor lokasi yang dimasukkan ada di jalan yang dimasukkan, tetapi untuk mencapai alamat yang sepenuhnya terverifikasi/dapat dikirimkan, nomor sub-lokasi yang valid juga harus diberikan.
Dengan kata lain, sub-lokasi tidak ada dalam input.

S

Konfirmasikan alamat

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

Artinya, nomor lokasi yang dimasukkan ada di rute yang dimasukkan, tetapi sub-lokasi yang diberikan tidak ada di dalam gedung tersebut, menurut USPS.

Y

Menerima alamat

Alamat dikonfirmasi DPV untuk nomor utama dan sekunder.

Artinya, alamat dapat dikirimkan sepenuhnya oleh USPS, termasuk nomor sub-lokasi, jika berlaku.

Bagian ini 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
  • Region: USA
  • Kolom dpvConfirmation menampilkan: N

Ini adalah sinyal yang sangat kuat bahwa nomor lokasi ini tidak ada di rute ini. Seperti alamat bermasalah lainnya, sistem Anda harus meminta pengguna untuk melakukan koreksi.

Contoh DPV D - memperbaiki alamat

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

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

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

Contoh DPV S - konfirmasikan alamat

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

  • Alamat yang dimasukkan: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
  • Region: USA
  • Kolom dpvConfirmation menampilkan: S

Hal ini menunjukkan bahwa, meskipun 1600 Amphitheatre Parkway ada sebagai alamat yang dapat menerima surat, sub-lokasi Ste 101 bukan merupakan bagian alamat yang valid. Sistem Anda harus mengonfirmasi informasi ini kepada pengguna dan memberikan kesempatan untuk melakukan koreksi.

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: USA
  • Kolom dpvConfirmation menampilkan: Y

Alamat dapat dikirimkan sepenuhnya oleh USPS. Hal ini memberi Anda tingkat keyakinan yang sangat tinggi bahwa API menampilkan alamat berkualitas baik, dan Anda dapat menggunakannya sebagaimana adanya.

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

Pesan keamanan untuk alamat AS

Bagian ini membahas flag keamanan yang disediakan dalam data USPS untuk alamat yang dibuat secara artifisial. Tindakan keamanan ini dirancang untuk mencegah pembuatan daftar alamat secara artifisial dengan mendeteksi saat alamat yang dikirimkan tampaknya dibuat secara artifisial dan tidak diperoleh secara sah. Hal ini sangat jarang terjadi.

Saat USPS mengidentifikasi alamat yang dibuat secara artifisial, errorMessage kolom properti uspsData 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.