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

Address Validation API là một dịch vụ chấp nhận địa chỉ. Phương thức này xác định các thành phần địa chỉ và xác thực các thành phần đó. Hàm 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ỉ đó. Đối với các địa chỉ ở Hoa Kỳ và Puerto Rico, bạn có thể bật Hệ thống hỗ trợ độ chính xác mã hoá (CASS™) (không bắt buộc).

Lý do sử dụng Address Validation API

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

API Địa chỉ được mã hoá địa lý 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ỉ. API Mã hoá địa lý chuyển đổi địa chỉ thành toạ độ vĩ độ và kinh độ. Address Validation API xác thực địa chỉ để đảm bảo đúng. Hãy xem nội dung Tạo 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

Dùng thử bản minh hoạ

Với API Xác thực địa chỉ, bạn có thể xác định xem một địa chỉ có đề cập đến một địa điểm thực tế hay không. Nếu địa chỉ không đề cập đến 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. Dưới đây là quy trình làm việc mẫu sử dụng API:

  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.

    Địa chỉ do khách hàng nhập.

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

  4. Khách hàng xác nhận hoặc sửa địa chỉ – Tuỳ thuộc vào nội dung 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ỉ.

    Yêu cầu khách hàng xác nhận địa chỉ do API xác định.Nhắc khách hàng nhập thông tin địa chỉ còn thiếu. Nhắc khách hàng sửa thông tin đị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ạng nội dung JSON. Phương thức này tách địa chỉ thành các thành phần riêng lẻ, sau đó thử những thao tác sau:

  • Chỉnh sửa – Cung cấp các bước kiểm tra xác thực ở cấp thành phần, bao gồm cả cá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 API Xác thực địa chỉ cùng với dữ liệu mà API này trả về. Để biết thông tin chi tiết cụ thể, hãy xem tài liệu tham khảo về API Xác thực địa chỉ.

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 bài viết Xác thực địa chỉ.

Địa chỉ đầy đủ, đã được xác thực (nếu có thể).

Trạng thái xác thực của từng thành phần địa chỉ.

Thông tin về số điện thoại (nếu có) của 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 về 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 dạng đị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ả cá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 áp dụng Xem thông tin chi tiết về phạm vi để biết API Xác thực địa chỉ hỗ trợ những quốc gia và khu vực nào.
3 Thiết lập Bắt đầu bằng cách Thiết lập dự án Google Cloud rồi 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 API Xác thực địa chỉ cung cấp hai thuộc tính, mỗi thuộc tính bạn sử dụng theo 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 API Xác thực địa chỉ. Xem bài viết Xử lý địa chỉ đã 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 API Xác thực địa chỉ, 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®)1 duy trì Hệ thống hỗ trợ độ chính xác mã hoá (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 Chứng nhận CASS™, chẳng hạn như 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 vào đị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 sử dụng 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à được tạo một cách nhân 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, bạn đồng ý với các Điều khoản cụ thể về dịch vụ này.

Bước tiếp theo

  1. Google Maps Platform là Bên được cấp phép không độc quyền của Dịch vụ Bưu chính Hoa Kỳ®. (Các) nhãn hiệu sau đây thuộc sở hữu của Dịch vụ Bưu chính Hoa Kỳ® và được sử dụng theo sự cho phép: Dịch vụ Bưu chính Hoa Kỳ®, CASS™, CASS Certified™. ↩