Tổng quan về API xác thực địa chỉ

Giới thiệu

Address Validation API là một dịch vụ chấp nhận địa chỉ. Dịch vụ này xác định các thành phần của địa chỉ và xác thực chúng. Thao tác này cũng chuẩn hoá địa chỉ để gửi thư và tìm toạ độ vĩ độ/kinh độ chính xác nhất cho địa chỉ đó. Bạn có thể bật Hệ thống hỗ trợ độ chính xác của mã (CASS™) cho địa chỉ ở Hoa Kỳ và Puerto Rico (không bắt buộc).

Lý do nên sử dụng Address Validation API

Với Address Validation API, bạn có thể cải thiện khả năng dự đoán việc giao hàng và giảm số lần giao hàng không thành công, từ đó nâng cao trải nghiệm của khách hàng. Bạn có thể thực hiện việc này bằng cách phát hiện địa chỉ không hợp lệ và nắm rõ hơn các đặc điểm của địa chỉ.

Geocoding API có thể phù hợp hơn với nhu cầu của bạn nếu bạn không cần xác thực từng thành phần địa chỉ. Geocoding API chuyển đổi địa chỉ thành toạ độ vĩ độ và kinh độ. Address Validation API xác thực địa chỉ để đảm bảo tính chính xác. Hãy xem bài viết Xây dựng khả năng xác thực vị trí bằng Google Maps Platform trong Trung tâm kiến trúc để biết thông tin so sánh chi tiết.

Những việc bạn có thể làm với Address Validation API

inputThử bản minh hoạ

Với Address Validation API, bạn có thể xác định xem một địa chỉ có phải là địa điểm có thực hay không. Nếu địa chỉ không phải là một địa điểm thực, API có thể xác định các thành phần có thể không chính xác mà bạn có thể trình bày cho khách hàng để sửa. Sau đây là quy trình mẫu sử dụng API này:

1. Khách hàng nhập địa chỉ – Hình ảnh sau đây cho thấy một biểu mẫu cơ bản cho phép khách hàng nhập địa chỉ, có thể là một phần của quy trình thanh toán.

2. Ứng dụng gửi địa chỉ đến API – Ứng dụng truyền địa chỉ này làm dữ liệu đầu vào cho Address Validation API.

   

3. API xác thực và chuẩn hoá địa chỉ – Trong phản hồi của mình, Address Validation API sẽ trả về địa chỉ đầy đủ do API xác định hoặc cho biết thông tin bị thiếu.

4. Khách hàng xác nhận hoặc chỉnh sửa địa chỉ – Tuỳ thuộc vào thông tin mà API trả về, bạn có thể đưa ra các lời nhắc sau cho khách hàng: A. Xác nhận địa chỉ được đề xuất. B. Cung cấp thông tin còn thiếu. C. Sửa địa chỉ.

   

Cách hoạt động của Address Validation API

Quy trình xác thực địa chỉ chấp nhận yêu cầu POST có địa chỉ dưới dạng nội dung JSON. Dịch vụ này phân tách địa chỉ thành các thành phần riêng lẻ, sau đó thử thực hiện những việc sau:

• Chính xác – Cung cấp các quy trình kiểm tra xác thực ở cấp thành phần, bao gồm cả cơ sở phụ (nếu có).
• Hoàn tất – Cố gắng suy luận các thành phần địa chỉ bị thiếu hoặc không chính xác.
• Định dạng – Dọn dẹp và chuẩn hoá định dạng cho các thành phần địa chỉ.

Tài nguyên

Bảng sau đây tóm tắt các tài nguyên có sẵn thông qua Address Validation API cùng với dữ liệu mà API này trả về. Để biết thông tin cụ thể, hãy xem Tài liệu tham khảo về Address Validation API.

Tài nguyên dữ liệu	Dữ liệu được trả về
Các thành phần địa chỉ ở định dạng JSON. Xem phần Xác thực địa chỉ.	Địa chỉ đầy đủ, hợp lệ (nếu có thể). Trạng thái xác thực của từng thành phần địa chỉ. Nơi có sẵn cho một địa chỉ: Mã địa lý Độ chính xác của địa chỉ Dữ liệu về dịch vụ bưu chính (nếu có). Xem phần Tìm hiểu phản hồi xác thực.

Cách sử dụng Address Validation API

1	Dùng thử bản minh hoạ	Khám phá bản minh hoạ với nhiều biểu mẫu địa chỉ, cả chính xác và không chính xác. Bản minh hoạ này cung cấp một cách hữu ích để khám phá cả giá trị trả về từ dịch vụ, cũng như phản hồi API được định dạng JSON.
2	Kiểm tra phạm vi phủ sóng	Xem thông tin chi tiết về phạm vi cung cấp để biết những quốc gia và khu vực mà Address Validation API hỗ trợ.
3	Thiết lập	Bắt đầu bằng cách Thiết lập dự án Google Cloud và hoàn tất các hướng dẫn sau.
4	Yêu cầu xác thực địa chỉ	Bắt đầu bằng một địa chỉ cơ bản, sau đó, để tăng độ chính xác, bạn có thể bật CASS (chỉ dành cho địa chỉ ở Hoa Kỳ và Puerto Rico). Xem phần Yêu cầu xác thực địa chỉ.
5	Xử lý phản hồi	Phản hồi của Address Validation API cung cấp 2 thuộc tính, mỗi thuộc tính mà bạn sử dụng theo những cách khác nhau. Xem phần Tìm hiểu về phản hồi cơ bản.
6	Cải thiện độ chính xác của quy trình xác thực	Bạn có thể giúp cải thiện độ chính xác của địa chỉ bằng cách cung cấp ý kiến phản hồi về các phản hồi của Address Validation API. Xem phần Xử lý địa chỉ được cập nhật.

Các thư viện ứng dụng hiện có

Để biết danh sách các thư viện ứng dụng hiện có cho Address Validation API, hãy xem phần Thư viện ứng dụng.

Giới thiệu về CASS™

Dịch vụ Bưu chính Hoa Kỳ® (USPS®)¹ duy trì Hệ thống hỗ trợ độ chính xác của mã (CASS™) để hỗ trợ và chứng nhận các nhà cung cấp dịch vụ xác thực địa chỉ. Một dịch vụ được CASS Certified™ (Chứng nhận CASS), chẳng hạn như Address Validation API (API Xác thực địa chỉ), đã được xác nhận về khả năng điền thông tin còn thiếu trong địa chỉ, chuẩn hoá và cập nhật địa chỉ để cung cấp cho bạn địa chỉ mới nhất và chính xác nhất.

CASS không được bật theo mặc định và chỉ được hỗ trợ cho các khu vực "Hoa Kỳ" và "Puerto Rico". Để bật CASS, hãy đặt enableUspsCass thành true trong yêu cầu xác thực. Để biết thêm thông tin, hãy xem phần Xác thực địa chỉ.

Trong quá trình chúng tôi sử dụng các dịch vụ của USPS, USPS sẽ đánh giá các yêu cầu về địa chỉ được tạo nhân tạo. Nếu USPS xác định một địa chỉ đầu vào là do người dùng tạo ra một cách giả tạo, thì Google phải ngừng xác thực địa chỉ cho khách hàng và phải báo cáo thông tin liên hệ của khách hàng (tên và địa chỉ), địa chỉ đầu vào có liên quan và dữ liệu sử dụng tổng hợp cho USPS. Bằng việc sử dụng API này, bạn đồng ý với các Điều khoản cụ thể về dịch vụ này.

Bước tiếp theo

• Thử bản minh hoạ: Chuyển đến phần Bản minh hoạ
• Xem xét các khu vực được hỗ trợ: Chuyển đến phần Thông tin chi tiết về phạm vi hỗ trợ theo quốc gia và khu vực
• Thử yêu cầu xác thực đầu tiên: Chuyển đến phần Gửi yêu cầu xác thực địa chỉ
• Xử lý địa chỉ với số lượng lớn: Chuyển đến phần Sử dụng Address Validation API để xử lý địa chỉ với số lượng lớn