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

Tài liệu này trình bày quy trình xác thực địa chỉ dành riêng cho Hoa Kỳ:

• Sử dụng dữ liệu của USPS trong quy trình làm việc
• Các trường Xác minh điểm giao hàng của USPS (dpv)
• Thông báo bảo mật

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

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

Lưu ý quan trọng: Nếu hệ thống của bạn chủ yếu hoặc chỉ xử lý địa chỉ ở Hoa Kỳ, bạn có thể chọn sử dụng đối tượng phản hồi này làm điểm tham chiếu đầu tiên trong logic kiểm tra của mình. Tuy nhiên, bạn cần lưu ý rằng đối tượng uspsData không được đảm bảo sẽ được điền đầy đủ cho mọi địa chỉ do dịch vụ xác thực.

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 chỉ dựa vào thuộc tính này để xác thực địa chỉ, mà thay vào đó, hãy kết hợp kết quả và các thành phần địa chỉ vào hệ thống của bạn.

Xác minh điểm giao hàng (DPV) của Bưu điện Hoa Kỳ (USPS)

Trong 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ể giao hàng đến địa chỉ được cung cấp hay không.

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

• tính hợp lệ của địa chỉ.
• nếu địa chỉ thiếu số căn hộ.
• nếu số đơn vị không có trong hệ thống dữ liệu của USPS.

Dịch vụ này trả về một trong bốn giá trị dpvConfirmation hoặc không trả về giá trị dpvConfirmation nào. Bảng bên dưới cho thấy hành vi có thể có mà logic của bạn có thể sử dụng cho từng 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 Quy trình làm việc mẫu trong phần Tạo logic xác thực.

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

Phần còn lại của phần này thảo luận về các trường hợp thực tế sử dụng mã DPV.

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

Ví dụ này sử dụng một 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ố nhà này không tồn tại trên tuyến đường này. Giống như các địa chỉ có vấn đề khác, hệ thống của bạn sẽ nhắc người dùng chỉnh sửa.

Ví dụ về DPV D – thêm cơ sở phụ

Ví dụ này sử dụng văn phòng của Google ở New York, nhưng không có cơ sở phụ (đây 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ó thông tin về địa điểm 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 địa điểm phụ bị thiếu trong dữ liệu đầu vào. Để đạt được DPV là Y, bạn phải đưa một tiền đề phụ hợp lệ vào làm một phần của dữ liệu đầu vào. Ví dụ: bạn có thể thêm một cơ sở phụ hợp lệ là FL 4 (Tầng 4) để nhận được giá trị dpvConfirmation là Y.

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

Ví dụ này sử dụng một 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 là một địa chỉ hợp lệ, nhưng Suite 101 không phải là một phần hợp lệ của địa chỉ. Bạn có thể cân nhắc việc xác nhận thông tin này với người dùng và tạo cơ hội để họ chỉnh sửa.

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

Ví dụ này sử dụng địa chỉ Googleplex ở Mountain View, California làm địa chỉ hợp lệ đã 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 hàng đến địa chỉ này. Điều này giúp bạn 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. Như thường lệ, hãy cân nhắc mức độ rủi ro khi quyết định có nên nhắc khách hàng xác nhận hay không.

Lưu ý: DPV không cho biết liệu Address Validation API 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ông báo bảo mật cho địa chỉ ở Hoa Kỳ

Phần này trình bày các cờ bảo mật có trong dữ liệu của 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 việc tạo danh sách địa chỉ giả tạo bằng cách phát hiện thời điểm một địa chỉ được gửi có vẻ như được tạo ra một cách giả tạo và không thu được một cách hợp pháp. Điều này rất hiếm khi xảy ra.

Khi USPS xác định một địa chỉ được tạo nhân tạo, trường errorMessage của thuộc tính uspsData trong phản hồi sẽ chứa một 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.

Lưu ý: Khi uspsData cho biết một địa chỉ giả tạo, phản hồi cho các thuộc tính khác trong phản hồi của API Xác thực địa chỉ sẽ không bị ảnh hưởng.