Nhận Maps Demo Key: Dùng thử miễn phí một số tính năng của Maps JavaScript API và Places UI Kit bằng Maps Demo Key mà không cần cung cấp thông tin thanh toán.

Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

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 công 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 công việc của bạn

Khi xác thực địa chỉ ở Hoa Kỳ, Address Validation API cũng có thể điền sẵn phần uspsData của kết quả 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 thuộc tính này làm phương tiện duy nhất để xác thực địa chỉ, mà thay vào đó, hãy kết hợp cả kết quả và thành phần địa chỉ vào hệ thống của bạn.

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

Trong phản hồi uspsData, trường dpvConfirmation trả về một ký 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 địa chỉ thiếu số căn hộ.
nếu số nhà phụ không tồn tại 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 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 bài viết Xây dựng logic xác thực.

Giá trị	Hành vi	Nội dung mô tả
Không hoặc trống	Chỉnh sửa địa chỉ	Địa chỉ này chưa được xác nhận DPV. Điều này có nghĩa là USPS không nhận ra số nhà đã nhập tồn tại trên đường (tuyến đường) đã nhập và không thể giao hàng đến đó.
D	Chỉnh sửa địa chỉ	Địa chỉ đã được DPV xác nhận chỉ cho số chính và thiếu thông tin về số phụ. Điều này có nghĩa là số nhà đã nhập tồn tại trên đường phố đã nhập, nhưng để có được địa chỉ đã 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, thông tin đầu vào thiếu địa điểm phụ.
N	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ó tồn tại nhưng chưa được xác nhận. Điều này có nghĩa là số nhà đã nhập có tồn tại trên tuyến đường đã nhập, nhưng số nhà phụ được 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ố chính và mọi số 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 mục 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à 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. Cũ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 – sửa địa chỉ

Ví dụ này sử dụng văn phòng Google ở New York, nhưng không chứa một phần 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 thông tin về toà nhà phụ bị thiếu trong dữ liệu đầu vào. Để có được DPV là Y, bạn phải đưa một địa điểm phụ hợp lệ vào dữ liệu đầu vào. Ví dụ: bạn có thể thêm một địa điểm 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 số căn hộ 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 biết 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ỉ 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à tạo cơ hội để người dùng 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, 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

Địa chỉ này hoàn toàn có thể được USPS giao hàng. Điều này giúp bạn tin tưởng 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 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 cung cấp trong dữ liệu của USPS cho đị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ỉ giả 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 giả 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, 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.