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

Nhà phát triển ở Khu vực kinh tế Châu Âu (EEA)

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. Dịch vụ này cũng chuẩn hoá địa chỉ để gửi thư và tìm toạ độ vĩ độ/kinh độ được biết đến nhiều nhất cho địa chỉ đó. Bạn có thể bật Hệ thống hỗ trợ độ chính xác của mã hoá (CASS™) cho các địa chỉ ở Hoa Kỳ và Puerto Rico.

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ừ đó cải thiện trải nghiệm của khách hàng. Bạn có thể làm việc này bằng cách phát hiện các địa chỉ không hợp lệ và nắm rõ hơn các đặc điểm của địa chỉ.

Lưu ý khác

Address Validation API xác thực tính chính xác của địa chỉ. Geocoding API chuyển đổi địa chỉ thành toạ độ vĩ độ và kinh độ. 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 để so sánh chi tiết.

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 của địa chỉ hoặc nếu bạn cần thông tin chi tiết về đích đến ở cấp độ siêu địa phương, chẳng hạn như lối vào toà nhà, đường viền toà nhà và điểm điều hướng.

Geocoding API v4 ra mắt phương thức SearchDestinations, trả về toạ độ cho lối vào toà nhà, điểm điều hướng và đường viền toà nhà. Hãy xem phần Tìm kiếm đích đến của Geocoding API v4 để biết thêm thông tin chi tiết.

Các thao tác mà bạn có thể thực hiện với Address Validation API

Thử 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à một địa điểm thực hay không. Nếu địa chỉ đó không phải là một địa điểm thực, thì 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ể cung cấp cho khách hàng để họ chỉnh sửa. Dưới đâ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 sẽ 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, Address Validation API sẽ trả về địa chỉ đầy đủ do API xác định hoặc cho biết thông tin còn 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. Chỉnh 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. Yêu cầu 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. Quy trình này sẽ 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 sửa—Cung cấp các lượt 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 còn thiếu hoặc không chính xác của địa chỉ.
  • Định dạng—Dọn dẹp và chuẩn hoá định dạng cho các thành phần của đị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 chi tiết 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 của địa chỉ ở định dạng JSON.

Xem bài viết Xác thực địa chỉ.

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

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

Đối với một địa chỉ (nếu có):

  • 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 bài viết Tìm hiểu phản hồi xác thực.

Cách sử dụng Address Validation API

1 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ạ 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 ở định dạng JSON.
2 Kiểm tra phạm vi cung cấp 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 trên Google Cloud và hoàn tất các hướng dẫn tiếp theo.
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 bài viết 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 được sử dụng theo những cách khác nhau. Xem bài viết Tìm hiểu 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 gửi ý kiến phản hồi về phản hồi của Address Validation API. Xem bài viết Xử lý địa chỉ đã cập nhật.

Thư viện ứng dụng có sẵn

Để xem danh sách các thư viện ứng dụng có sẵn cho Address Validation API, hãy xem 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 của 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 CASS Certified™ (chẳng hạn như Address Validation API) đã được xác nhận về khả năng điền thông tin còn thiếu trong địa chỉ, chuẩn hoá địa chỉ 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 "US" và "PR". Để 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 bài viết Xác thực địa chỉ.

Trong quá trình bạn sử dụng các dịch vụ của USPS, USPS sẽ đánh giá các yêu cầu đối với địa chỉ được tạo nhân tạo. Nếu USPS xác định một địa chỉ đầu vào được tạo 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 cách 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

  1. Google Maps Platform là Người đượ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 khi có sự cho phép: Dịch vụ bưu chính Hoa Kỳ®, CASS™, CASS Certified™. ↩