Tài liệu này đề cập đến 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 giao hàng theo 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 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 dựa vào đối tượng này làm phương tiện duy nhất để xác thực địa chỉ, nhưng thay vào đó kết hợp kết quả và địa chỉ vào hệ thống của bạn.
Xác minh điểm giao hàng USPS (DPV)
Trong phản hồi uspsData
, trường dpvConfirmation
sẽ trả về một giá trị duy nhất
để cho bạn biết liệu USPS có thể giao hàng đế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:
- tính hợp lệ của địa chỉ.
- nếu thiếu số của toà nhà trong địa chỉ.
- nếu số toà nhà phụ không tồn tại trong hệ thống dữ liệu USPS.
Dịch vụ trả về một trong bốn giá trị dpvConfirmation
hoặc không trả về
trả về giá trị dpvConfirmation
. Bảng dưới đây trình bày các phương pháp
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
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 |
Chỉnh sửa địa chỉ |
Địa chỉ chưa được xác nhận DPV. Điều này có nghĩa là USPS không nhận ra số toà nhà đã nhập có sẵn trên đường (tuyến đường) đã nhập và không thể giao hàng ở đó. |
D |
Chỉnh sửa địa chỉ |
Địa chỉ đã được xác nhận DPV chỉ cho số điện thoại chính và
thiếu thông tin về số phụ. |
CN |
Xác nhận địa chỉ |
Địa chỉ đã được xác nhận DPV chỉ cho số điện thoại chính và đã có thông tin về số phụ nhưng chưa được xác nhận. Điều này có nghĩa là số nhà đã nhập tồn tại trên tuyến đường đã nhập, nhưng tiền đề được cung cấp không tồn tại bên trong toà nhà đó, theo lên USPS. |
Có |
Chấp nhận địa chỉ |
Địa chỉ đã được xác nhận DPV cho các số chính và mọi số phụ. Điều này có nghĩa là USPS có thể giao đến địa chỉ đầy đủ, bao gồm số điện thoại 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ố đường không tồn tại trên một địa chỉ khác 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 mẽ cho biết 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 sẽ nhắc cho 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 đề là một phần bắt buộc của địa chỉ. Bạn có thể kiểm tra đ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ề tiền đề.
- Đị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 dữ liệu đầu vào bị thiếu tiền đề phụ. Cách sử dụng DPV
Y, tiền đề phụ hợp lệ phải được đưa vào dữ liệu đầu vào. Ví dụ:
bạn có thể bao gồm một tiền đề phụ hợp lệ là FL 4 (Tầng 4) để có được
Giá trị dpvConfirmation
của 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 tồn tại dưới dạng một địa chỉ có thể chấp nhận thư, tiền đề phụ Ste 101 không phải là 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à cung cấp cơ hội điều chỉnh.
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 cao nổi tiếng.
- Địa chỉ đã nhập: 1600 Amphitheatre Parkway, Mountain View, CA, 94043
- Khu vực: Hoa Kỳ
- Trường
dpvConfirmation
trả về:Y
Địa chỉ có thể giao đầy đủ bởi USPS. Điều này mang lại cho bạn mức độ rất cao niềm tin rằng API đã trả về một địa chỉ có chất lượng tốt và bạn có thể sử dụng nó như được cung cấp.
Lưu ý: DPV không cho biết liệu API xác thực địa chỉ đã thực hiện bất kỳ các thay đổi đối với đầu vào, 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ờ bảo mật được cung cấp trong dữ liệu USPS cho địa chỉ giả tạo. Biện pháp bảo mật này được thiết kế để ngăn chặn tạo danh sách địa chỉ giả tạo bằng cách phát hiện khi một địa chỉ đã gửi có vẻ như được tạo 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 một địa chỉ được tạo giả tạo, errorMessage
trường của thuộc tính uspsData của phản hồi có chứa
thông báo lỗi mô tả sự cố. 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.