Lý do bạn 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, từ đó cải thiện trải nghiệm khách hàng. Bạn làm được điều này bằng cách phát hiện ra những địa chỉ không hợp lệ và hiểu 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 các thành phần địa chỉ riêng lẻ. API mã hoá địa lý chuyển đổi các địa chỉ thành toạ độ vĩ độ/kinh độ, trong khi API Xác thực địa chỉ xác thực địa chỉ để đảm bảo tính chính xác. Hãy xem bài viết Khả năng xác thực vị trí toà nhà bằng Nền tảng Google Maps 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 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 tham chiếu đến 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ể hiển thị cho khách hàng để sửa. Dưới đây là quy trình làm việc mẫu sử dụng API:
Khách hàng nhập địa chỉ – Hình ảnh sau đây hiển thị 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 của quy trình thanh toán.
Ứng dụng gửi địa chỉ đến API – Ứng dụng sẽ chuyển địa chỉ này dưới dạng thông tin đầu vào đến API xác thực địa chỉ.
API xác thực và chuẩn hoá địa chỉ – Trong phản hồi, Address Validation API trả về địa chỉ đầy đủ như do API xác định hoặc cho biết thông tin bị thiếu.
Khách hàng chỉnh 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:
Đưa ra một địa chỉ đề xuất để khách hàng xác nhận:
Nhắc khách hàng thêm thông tin 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ỉ đầu vào do thông tin bị thiếu hoặc không chính xác:
Cách hoạt động của API xác thực địa chỉ
Quy trình 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. Phương thức này 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 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.
- Được định dạng hợp lý – Dọn dẹp và chuẩn hoá định dạng cho các thành phần địa chỉ.
Thử bản minh hoạ để xem Address Validation API (API Xác thực địa chỉ) hoạt động như thế nào.
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 trả về. Để biết thông tin 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ề |
|---|---|
|
Địa chỉ thành phần ở định dạng JSON. Hãy xem phần Xác thực địa chỉ. |
Địa chỉ đầy đủ, đã 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ỉ. Những nơi có thể sử dụng một địa chỉ:
Hãy xem phần Tìm hiểu về phản hồi xác thực. |
Cách sử dụng API Xác thực địa chỉ
| 1 | Xem bản minh hoạ | Khám phá bản minh hoạ với một loạt các biểu mẫu địa chỉ, cả chính xác và không chính xác. Bản minh hoạ mang đến 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 của API theo định dạng JSON. |
| 2 | Kiểm tra mức độ phù hợp | Xem xét thông tin chi tiết về phạm vi áp dụng để biết những quốc gia và khu vực mà API Xác thực địa chỉ hỗ trợ. |
| 3 | Thiết lập | Hãy bắt đầu bằng việc Thiết lập dự án Google Cloud và hoàn thành hướng dẫn sau đó. |
| 4 | Yêu cầu xác thực địa chỉ | Hãy bắt đầu bằng 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 địa chỉ ở Hoa Kỳ và Quan hệ công chúng). 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 2 thuộc tính, mỗi thuộc tính sẽ được sử dụng theo những cách khác nhau. Xem phần Tìm hiểu về 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ề phản hồi của API Xác thực địa chỉ. Hãy xem bài viết Xử lý địa chỉ đã cập nhật. |
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ề CASSTM
United States Postal Service® (USPS®)1 duy trì Hệ thống hỗ trợ độ chính xác của mã hoá (CASSTM) để 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ụ CASS CertificateTM (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 một địa chỉ, chuẩn hoá và cập nhật thông tin đó để 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 mà chỉ được hỗ trợ cho 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 một địa chỉ.
Trong quá trình sử dụng các dịch vụ của USPS, USPS đánh giá yêu cầu đối với các địa chỉ được tạo giả tạo. Nếu USPS xác định rằng một địa chỉ đầu vào được tạo một cách giả tạo, thì Google bắt buộc phải dừng xác thực các địa chỉ của khách hàng và phải báo cáo thông tin liên hệ (tên và địa chỉ) của khách hàng, địa chỉ nhập 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.
Bước tiếp theo
- Xem phần Câu hỏi thường gặp: Chuyển đến mục Câu hỏi thường gặp
- Xem xét khu vực phủ sóng: Chuyển đến phần Thông tin chi tiết về quốc gia và khu vực
- Xử lý địa chỉ ở khối lượng lớn: Chuyển đến phần Sử dụng API xác thực địa chỉ để xử lý địa chỉ khối lượng lớn
-
Google Maps Platform là một bên được cấp phép không độc quyền của United States Postal Service®. (Các) nhãn hiệu sau đây thuộc sở hữu của United States Postal Service® và được sử dụng theo sự cho phép: United States Postal Service®, CASSTM, CASS CertificationTM. ↩