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 USPS trong quy trình làm việc của bạn

Khi xác thực địa chỉ ở Hoa Kỳ, dịch vụ API Xác thực địa chỉ cũng có thể điền phần uspsData của dữ liệu 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. Tuy nhiên, điều quan trọng là bạn phải biết rằng đối tượng uspsData không được đảm bảo được điền đầy đủ cho mọi địa chỉ mà 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 dựa vào 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 đó, kết hợp kết quả và các thành phần địa chỉ vào hệ thống của mình.

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

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ể 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 những thông tin sau:

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

Dịch vụ này sẽ trả về một trong bốn giá trị dpvConfirmation hoặc không trả về giá trị dpvConfirmation nào cả. Bảng dưới đây cho thấy hành vi đề 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 bài viết Sử dụng phản hồi xác thực.

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

Phần còn lại của phần này sẽ 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à 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ư với các địa chỉ có vấn đề khác, hệ thống của bạn phải nhắc người dùng chỉnh 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 ở New York, nhưng không chứa tiền đề 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 mẫu minh hoạ mà không có thông tin về cơ sở 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. Để có DPV là Y, tiền đề phụ hợp lệ phải được đưa vào như một phần của đầu vào. Ví dụ: bạn có thể thêm tiền đề phụ hợp lệ là FL 4 (Tầng 4) để nhận giá trị dpvConfirmation là Y.

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

Ví dụ này sử dụng số tiền phòng 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ỉ có thể nhận thư, nhưng địa chỉ phụ Ste 101 không phải là một phần hợp lệ của địa chỉ. 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 người dùng cơ hội sửa đổi.

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ỉ 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

Địa chỉ này có thể giao hàng đầy đủ qua USPS. Đ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ư đã 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ông báo bảo mật cho đị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 giả 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ỉ một cá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 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 nhân tạo, trường errorMessage của thuộc tính uspsData trong 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.

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