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

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

API xác thực địa chỉ là một dịch vụ chấp nhận địa chỉ. Nó xác định các thành phần địa chỉ và xác thực chúng. Nó cũng chuẩn hóa địa chỉ gửi thư và tìm tọa độ vĩ độ/kinh độ đã biết tốt nhất cho địa chỉ đó. Nếu muốn cho các địa chỉ ở Hoa Kỳ và Puerto Rico, bạn có thể bật Hệ thống hỗ trợ độ chính xác của mã (CASSTM).

Tại sao nên sử dụng API xác thực địa chỉ

Với API xác thực địa chỉ, bạn có thể cải thiện khả năng dự đoán phân phối và giảm lỗi phân phối, nhờ đó cải thiện trải nghiệm của khách hàng. Bạn làm điều này bằng cách phát hiện các địa chỉ xấu và nắm rõ hơn đặc điểm của các địa chỉ.

Nếu bạn không cần xác thực các thành phần địa chỉ riêng lẻ cho yêu cầu của mình, API mã hóa địa lý có thể phù hợp hơn với nhu cầu của bạn. API mã hóa địa lý chuyển đổi địa chỉ thành tọa độ vĩ độ/kinh độ, trong khi API xác thực địa chỉ xác thực địa chỉ cho chính xác. Để biết thông tin chi tiết, hãy xem phần Cách API xác thực địa chỉ hoạt động bên dưới cũng như thông tin tổng quan về API mã hoá địa lý.

Những việc bạn có thể làm với API xác thực địa chỉ

Với API xác thực địa chỉ, bạn có thể xác định xem địa chỉ có tham chiếu đế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 tế, 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 của bạn để sửa chữa. Dưới đây là luồng công việc mẫu sử dụng API:

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

  2. Ứng dụng gửi địa chỉ đến API – Ứng dụng chuyển địa chỉ này làm dữ liệu đầu vào cho API xác thực địa chỉ.

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

  4. Khách hàng sửa hoặc xác nhận địa chỉ được đề xuất – Tùy thuộc vào API trả về, bạn có thể đưa ra các lời nhắc sau đây cho khách hàng:

    • Cung cấp địa chỉ được đề xuất để khách hàng xác nhận:
      Yêu cầu khách hàng xác nhận địa chỉ theo như quy định của API.

    • Nhắc khách hàng thêm thông tin còn thiếu:
      Nhắc khách hàng nhập thông tin địa chỉ còn thiếu.

    • Nhắc người dùng sửa địa chỉ nếu API không thể xác thực địa chỉ đã nhập do thông tin bị thiếu hoặc không chính xác:
      Nhắc khách hàng sửa thông tin địa chỉ.

Cách hoạt động của API xác thực địa chỉ

Việc xác thực địa chỉ chấp nhận yêu cầu POST có địa chỉ ở dạng nội dung JSON. Nó phân tách địa chỉ thành các thành phần riêng lẻ, sau đó kiểm tra và sửa lỗi sau:

  • 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ơ sở phụ nếu có.
  • Cố suy luận các thành phần địa chỉ bị thiếu hoặc không chính xác.
  • Dọn dẹp và chuẩn hoá định dạng cho các thành phần địa chỉ.

Thử bản trình diễn để xem API xác thực địa chỉ trong thực tế.

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 API xác thực địa chỉ.

Tài nguyên dữ liệu Đã trả về dữ liệu

Giải quyết các thành phần ở định dạng JSON.

Xem 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ỉ.

Nếu địa chỉ có sẵn:

  • Mã địa lý
  • Độ chính xác của địa chỉ
  • Dữ liệu dịch vụ bưu chính (nếu có).

Xem Hiểu phản hồi xác thực.

Cách sử dụng API xác thực địa chỉ

1 Dùng thử bản minh hoạ Khám phá bản minh hoạ bằng 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ề của dịch vụ cũng như phản hồi API có định dạng JSON.
2 Thiết lập. Hãy bắt đầu bằng việc Thiết lập dự án trên Google Cloud và hoàn thành các hướng dẫn tiếp theo.
3 Xác thực địa chỉ Bắt đầu bằng một địa chỉ đơn giản, sau đó để tăng mức độ chính xác, bạn có thể bật CASS (chỉ dành cho địa chỉ ở Hoa Kỳ và PR). Xem Xác thực địa chỉ.
4 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ẽ sử dụng theo nhiều cách. Xem Hiểu phản hồi xác thực.
5 Cải thiện độ chính xác của thông tin xác thực Bạn có thể giúp chúng tôi 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 Cung cấp phản hồi xác thực địa chỉ.

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

Để biết danh sách các thư viện ứng dụng có sẵn cho API xác thực địa chỉ, hãy xem phần Thư viện ứng dụng.

Giới thiệu về CASSTM

Hệ thống bưu chính Hoa Kỳ® (USPS®)1 duy trì Hệ thống hỗ trợ độ chính xác mã hóa (CASSTM) để hỗ trợ và chứng nhận các nhà cung cấp dịch vụ xác thực địa chỉ. Dịch vụ được chứng nhận CASSTM, 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 của địa chỉ, chuẩn hóa đị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.

Theo mặc định, CASS không được bật và chỉ được hỗ trợ ở khu vực "Hoa Kỳ" và "Quan hệ công chúng". Để 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ỉ.

Là một phần trong hoạt động sử dụng các dịch vụ của USPS, USPS đá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 là được tạo giả tạo, thì Google bắt buộc phải dừng xác thực địa chỉ của 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 dành riêng cho dịch vụ này.

Các bước tiếp theo

  1. Google Maps Platform là Người được cấp phép không độc quyền của Hoa Kỳ. Bưu điện®. (Các) nhãn hiệu sau thuộc sở hữu của Bưu điện Hoa Kỳ và được sự cho phép: Hoa Kỳ. Bưu điện®, CASSTM, Chứng nhận CASSTM. ↩