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 một địa chỉ. Trình quản lý thẻ của Google sẽ xác định và xác thực các thành phần địa chỉ. Hộp cát về quyền riêng tư 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ỉ gửi thư. Đối với các địa chỉ ở Hoa Kỳ và Puerto Rico, nếu muốn, bạn có thể bật Hệ thống hỗ trợ độ chính xác khi lập trình (CASSTM).

Lý do bạn nên dùng Address Validation API (API Xác thực địa chỉ)

Với Address Validation API (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 thiểu lỗi phân phối, nhờ đó cải thiện trải nghiệm cho khách hàng. Bạn thực hiện việc này bằng cách phát hiện các địa chỉ xấu và nắm rõ hơn về các đặc điểm của địa chỉ.

API 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ĩ độ/kinh độ, trong khi API xác thực địa chỉ xác thực địa chỉ về độ chính xác. Hãy xem phần Xây dựng tính năng xác thực vị trí bằng Nền tảng Google Maps trong Trung tâm kiến trúc để so sánh chi tiết.

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 một địa chỉ có tham chiếu đến một địa điểm thực hay không. Nếu địa chỉ không đề cập đến một vị trí 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ể đưa ra cho khách hàng của mình để 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 đơ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ỉ do 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 dưới dạng dữ liệu đầu vào cho API xác thực địa chỉ.

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

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

    • Trình bày địa chỉ đề xuất để khách hàng xác nhận:
      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 bổ sung 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 chỉnh 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ỉ sẽ chấp nhận yêu cầu POST với địa chỉ ở dạng nội dung JSON. Trình phân tích cú pháp sẽ tách địa chỉ thành các thành phần riêng lẻ, sau đó thực hiện các bước kiểm tra và chỉnh sửa sau đây:

  • Chính xác – Cung cấp quy trình 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 thành phần địa chỉ bị thiếu hoặc không chính xác.
  • Định dạng tốt – Dọn dẹp và chuẩn hoá định dạng cho các thành phần địa chỉ.

Dùng thử bản minh hoạ để 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 về API xác thực địa chỉ.

Tài nguyên về dữ liệu Dữ liệu được trả về

Địa chỉ các thành phần ở định dạng JSON.

Xem phần Xác thực địa chỉ.

Địa chỉ đầy đủ và đượ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ỉ.

Trường hợp áp dụng đối với một địa chỉ:

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

Hãy xem phần Tìm 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ạ 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ả các giá trị trả về của dịch vụ cũng như phản hồi API có định dạng JSON.
2 Kiểm tra mức độ phù hợp Xem lại thông tin chi tiết về phạm vi cung cấp để biết API xác thực địa chỉ hỗ trợ những quốc gia và khu vực nào.
3 Bắt đầu thiết lập Hãy bắt đầu từ việc Thiết lập dự án Google Cloud và hoàn thành các hướng dẫn tiếp theo.
4 Yêu cầu xác thực địa chỉ Bắt đầu với một địa chỉ đơn giản, sau đó để tăng độ chính xác, bạn có thể bật CASS (chỉ dành cho các địa chỉ ở Hoa Kỳ và PR). Hãy 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 được bạn sử dụng theo cách khác nhau. Hãy xem phần Hiểu câu trả lời cơ bản.
6 Cải thiện độ chính xác 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 đưa ra ý 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 về 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 hiện có cho API xác thực địa chỉ, hãy xem Thư viện ứng dụng.

Giới thiệu về CASSTM

Hoa Kỳ Postal Service® (USPS®)1 duy trì Hệ thống hỗ trợ độ chính xác của mã (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ụ CASS chứng nhậnTM (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 trong một đị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 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 phần Xác thực địa chỉ.

Trong quá trình sử dụng dịch vụ USPS, USPS đánh giá các yêu cầu đối với các địa chỉ được tạo giả 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 việc 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 Đ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à Bên được cấp phép không độc quyền của Hoa Kỳ Postal Service®. (Các) nhãn hiệu sau đây thuộc sở hữu của Hoa Kỳ Postal Service® và được sử dụng với sự cho phép: United States Postal Service®, CASSTM, CASS CertificationTM.