Xử lý địa chỉ ở Hoa Kỳ

Tài liệu này bao gồm việc xác thực địa chỉ dành riêng cho Hoa Kỳ:

• Sử dụng dữ liệu USPS trong quy trình làm việc
• Trường Xác minh điểm phân phối USPS (dpv)
• Thông báo bảo mật

Dữ liệu USPS trong quy trình làm việc của bạn

Khi xác thực các địa chỉ ở Hoa Kỳ, dịch vụ API xác thực địa chỉ cũng có thể điền sẵn phần uspsData của dữ liệu trả về.

Vì đối tượng này không phải lúc nào cũng được điền sẵn, nên bạn không nên coi thuộc tính này làm phương thức duy nhất để xác thực địa chỉ, mà thay vào đó, hãy kết hợp các thành phần kết quả và địa chỉ vào hệ thống của mình.

Xác minh điểm giao hàng USPS (DPV)

Là một phần của phản hồi uspsData, trường dpvConfirmation sẽ trả về một ký tự duy nhất để cho bạn biết liệu USPS có thể gửi đến địa chỉ đã cung cấp hay không.

Bạn có thể sử dụng trường này để xác định các thông tin sau:

• tính hợp lệ của địa chỉ.
• nếu địa chỉ thiếu số tòa nhà phụ.
• nếu số cơ sở phụ không tồn tại trong hệ thống dữ liệu USPS.

Dịch vụ trả về một trong 4 giá trị dpvConfirmation hoặc hoàn toàn không trả về giá trị dpvConfirmation. Bảng dưới đây cho thấy hành vi được đề xuất mà logic của bạn nên sử dụng cho từng kết quả trong số 5 kết quả có thể xảy ra. Để biết thêm thông tin chi tiết về logic này, hãy xem phần Tổng quan về quy trình công việc trong phần Sử dụng phản hồi xác thực.

Giá trị	Hành vi	Nội dung mô tả
Không có hoặc để trống	Chỉnh sửa địa chỉ	Địa chỉ chưa được DPV xác nhận. Điều này có nghĩa là USPS không nhận ra số cơ sở đã nhập tồn tại trên đường đã nhập (tuyến đường) và không thể giao hàng ở đó.
D	Chỉnh sửa địa chỉ	Địa chỉ được DPV xác nhận chỉ cho số điện thoại chính và thông tin về số điện thoại phụ bị thiếu. Điều này có nghĩa là số cơ sở lưu trú được nhập có tồn tại trên đường được nhập, nhưng để đến một địa chỉ có thể giao hàng/đã xác minh đầy đủ, bạn cũng cần cung cấp số cơ sở phụ hợp lệ. Nói cách khác, tiền đề phụ bị thiếu trong dữ liệu đầu vào.
S	Xác nhận địa chỉ	Địa chỉ được DPV xác nhận chỉ cho số điện thoại chính, và thông tin về số điện thoại phụ đã có mặt nhưng chưa được xác nhận. Điều này có nghĩa là số cơ sở được nhập tồn tại trên tuyến đường đã nhập, nhưng cơ sở hạ tầng được cung cấp không tồn tại trong toà nhà đó, theo USPS.
Y	Chấp nhận địa chỉ	Địa chỉ đã được xác nhận là DPV cho cả số chính và các số phụ. Điều này có nghĩa là USPS có thể giao toàn bộ địa chỉ đó, bao gồm cả số của cơ sở phụ, nếu có.

Phần còn lại của phần này thảo luận về các tình huống thực tế sử dụng mã DPV.

Ví dụ về DPV N – sửa địa chỉ

Ví dụ này sử dụng số nhà không tồn tại trên một địa chỉ hợp lệ.

• Địa chỉ đã nhập: 12 Amphitheatre Parkway, Mountain View, CA, 94043
• Khu vực: Hoa Kỳ
• Trường dpvConfirmation trả về: N

Đây là một tín hiệu cực kỳ mạnh cho thấy số tiền đề này không tồn tại trên tuyến đường này. Giống như với các địa chỉ có vấn đề khác, hệ thống của bạn nên nhắc người dùng sửa.

Ví dụ về DPV D – sửa địa chỉ

Ví dụ này sử dụng văn phòng của Google tại New York, nhưng không chứa trụ sở phụ là một phần bắt buộc của địa chỉ. Bạn có thể thấy điều này bằng cách sử dụng địa chỉ trong bản minh hoạ mà không cần thông tin tiền đề phụ.

• Địa chỉ đã nhập: 111 8th Avenue, New York, NY, 10011
• Khu vực: Hoa Kỳ
• Trường dpvConfirmation trả về: D

Điều này xác nhận rằng tiền đề phụ đã bị thiếu trong dữ liệu đầu vào. Để chuyển tới DPV của Y, bạn phải đưa vào tiền đề phụ hợp lệ làm một phần của đầu vào. Ví dụ: bạn có thể đưa vào tiền đề phụ hợp lệ là FL 4 (Tầng 4) để nhận giá trị dpvConfirmation của Y.

Ví dụ về DPV S – xác nhận địa chỉ

Ví dụ này sử dụng một số cơ sở phụ không tồn tại trong toà nhà:

• Địa chỉ đã nhập: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
• Khu vực: Hoa Kỳ
• Trường dpvConfirmation trả về: S

Điều này cho thấy rằng mặc dù 1600 Amphitheatre Parkway tồn tại dưới dạng địa chỉ có thể chấp nhận thư, nhưng cơ sở phụ Ste 101 không phải là một phần hợp lệ của địa chỉ này. Hệ thống của bạn phải xác nhận thông tin này với người dùng và cho họ cơ hội khắc phục.

Ví dụ về DPV Y – chấp nhận địa chỉ

Ví dụ này sử dụng địa chỉ Googleplex ở Mountain View, CA làm địa chỉ chất lượng đã biết.

• Địa chỉ đã nhập: 1600 Amphitheatre Parkway, Mountain View, CA, 94043
• Khu vực: Hoa Kỳ
• Trường dpvConfirmation trả về: Y

USPS có thể giao đầy đủ địa chỉ đó. Điều này mang lại cho bạn mức độ tin cậy rất cao rằng API trả về một địa chỉ có chất lượng tốt và bạn có thể sử dụng địa chỉ đó như được cung cấp.

Lưu ý: DPV không cho biết liệu API xác thực địa chỉ có thực hiện bất kỳ thay đổi nào đối với dữ liệu đầu vào hay không, chẳng hạn như sửa lỗi chính tả.

Thư bảo mật cho các địa chỉ ở Hoa Kỳ

Phần này đề cập đến các cờ bảo mật được cung cấp trong dữ liệu USPS cho các địa chỉ được tạo nhân tạo. Biện pháp bảo mật này được thiết kế để ngăn chặn hành vi tạo danh sách địa chỉ giả mạo bằng cách phát hiện thời điểm một địa chỉ đã gửi có vẻ như đã được xây dựng một cách giả tạo và không được lấy một cách hợp pháp. Trường hợp này rất hiếm khi xảy ra.

Khi USPS xác định được một địa chỉ được tạo giả tạo, trường errorMessage của thuộc tính uspsData của phản hồi sẽ chứa thông báo lỗi mô tả vấn đề. Ví dụ:

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.