Tài liệu này mô tả quy trình xây dựng hệ thống kiểm tra địa chỉ để xử lý nhiều phản hồi từ Address Validation API (API Xác thực địa chỉ). Tài liệu này trình bày cách xây dựng logic để sử dụng phản hồi một cách chính xác, điều tra các tín hiệu khác từ API, cũng như thời điểm và cách nhắc khách hàng cung cấp thêm thông tin.
Nhìn chung, phản hồi của API sẽ xác định những cách sau đây mà hệ thống của bạn nên xử lý địa chỉ:
- Fix (Khắc phục) – địa chỉ có chất lượng thấp. Bạn nên nhắc khách hàng cung cấp thêm thông tin.
- Xác nhận – địa chỉ có chất lượng cao nhưng đã thay đổi so với địa chỉ đầu vào. Bạn có thể nhắc khách hàng xác nhận.
- Accept (Chấp nhận) – địa chỉ có chất lượng cao. Bạn có thể chấp nhận địa chỉ được cung cấp.
Mục đích chính
Tài liệu này giúp bạn sửa đổi hệ thống để phân tích phản hồi của API một cách hiệu quả nhất và xác định các hành động tiếp theo cần thực hiện với các địa chỉ được cung cấp. Mã giả sau đây minh hoạ một luồng có thể xảy ra.
if (the API response indicates significant problems in the address)
FIX - prompt the user to fix the address
else if (the API response indicates less significant problems in the address)
CONFIRM - confirm with the user that the address is correct
else
ACCEPT - continue with the address returned by the API.
Logic chính xác phụ thuộc vào tình huống của bạn; hãy xem Hướng dẫn triển khai để biết thêm thông tin chi tiết. Bạn cũng có thể sử dụng cách triển khai nguồn mở của chúng tôi cho logic này, trong Thư viện thành phần mở rộng.
Tổng quan về quy trình làm việc
Bảng dưới đây tóm tắt 2 hành động cho hệ thống của bạn:
- Quy trình làm việc cần sử dụng dựa trên hành vi khắc phục, xác nhận, chấp nhận.
- Các tín hiệu đầu tiên cần kiểm tra từ phản hồi. Các tín hiệu được mô tả ở đây đến từ thuộc tính
verdictvà không phải là các tín hiệu duy nhất cần kiểm tra, nhưng cung cấp chỉ báo ban đầu về chất lượng địa chỉ. Mỗi loại hành vi tương ứng với một phần trong tài liệu này mô tả thêm các tín hiệu mà bạn cũng có thể cần điều tra.
| Hành vi của hệ thống | |||
|---|---|---|---|
| Fix the address (Khắc phục địa chỉ) |
Phản hồi từ
|
||
| Confirm the address (Xác nhận địa chỉ) |
Phản hồi từ
|
||
| Accept the address (Chấp nhận địa chỉ) |
Phản hồi của Address Validation API (API Xác thực địa chỉ) cho biết địa chỉ có chất lượng tuyệt vời.
|
||
Hướng dẫn triển khai
Khi thiết kế cách hệ thống của bạn phản hồi các tín hiệu xác thực địa chỉ, các đề xuất sau đây có thể giúp bạn xây dựng mô hình phản hồi hiệu quả hơn. Tuy nhiên, đây chỉ là các đề xuất, vì vậy, hãy lưu ý rằng cách triển khai của bạn phải phù hợp với mô hình kinh doanh của bạn.
| Hướng dẫn | Chi tiết | |
|---|---|---|
| Mức độ rủi ro |
Hãy cân nhắc mức độ chấp nhận cho tình huống của bạn khi cân bằng giữa việc nhắc khách hàng sửa và chấp nhận địa chỉ như đã nhập. |
Address Validation API (API Xác thực địa chỉ) trả về nhiều tín hiệu mà bạn có thể kết hợp với mức độ rủi ro của mình để tối ưu hoá quy trình xác thực. Ví dụ: nếu một địa chỉ có số nhà chưa được xác nhận, bạn vẫn có thể chấp nhận địa chỉ đó. Mặt khác, nếu hoạt động kinh doanh của bạn yêu cầu độ chính xác cao hơn về địa chỉ, bạn có thể nhắc người dùng. Để xem ví dụ có thể thuộc một trong hai danh mục, hãy xem Số nhà chưa được xác nhận ở ngoài Hoa Kỳ trong phần Chấp nhận địa chỉ – ví dụ. |
| Chấp nhận địa chỉ |
Bạn nên cho phép hệ thống chấp nhận mục nhập ban đầu nếu khách hàng không phản hồi lời nhắc. |
Trong những trường hợp này, khách hàng có thể đã nhập một địa chỉ không có trong hệ thống, chẳng hạn như địa chỉ của một công trình mới. |
Khắc phục địa chỉ
Khắc phục địa chỉ khi kết quả cho thấy rõ ràng rằng địa chỉ đó không thể giao hàng. Sau đó, hệ thống của bạn có thể nhắc khách hàng cung cấp thông tin cần thiết, sau đó bạn sẽ phát hành lại quy trình làm việc để nhận được địa chỉ có thể giao hàng.
Khắc phục tín hiệu
Address Validation API (API Xác thực địa chỉ) cung cấp một số tín hiệu để cho bạn biết liệu có nên khắc phục địa chỉ hay không.
1. Độ chi tiết của quy trình xác thực và các thành phần bị thiếu
Hai tín hiệu này cho biết rõ nhất về địa chỉ có vấn đề:
- Bất cứ khi nào trường
validationGranularitylàOTHER, hệ thống của bạn sẽ điều tra các tín hiệu thành phần địa chỉ để tìm hiểu thêm về vị trí xảy ra lỗi và cách khắc phục. - Bất cứ khi nào đối tượng
addressđã xử lý sau trả về trườngmissingComponentTypes, hệ thống của bạn sẽ kiểm tra thành phần đó. Các thành phần bị thiếu cũng khiến địa chỉ không đầy đủ và không thể giao hàng.
2. Các tín hiệu khác
Address Validation API (API Xác thực địa chỉ) cũng cung cấp các tín hiệu khác để giúp chẩn đoán các vấn đề cụ thể:
| Thành phần đáng ngờ | Khi enum cấp độ xác nhận cho một thành phần là
UNCOMFIRMED_AND_SUSPICIOUS, thì có khả năng thành phần đó
không chính xác.
|
|---|---|
| Thành phần chưa được giải quyết | An unresolvedToken là một phần của dữ liệu đầu vào không được nhận dạng là một phần hợp lệ của địa chỉ. |
3. Tín hiệu địa chỉ ở Hoa Kỳ
Một số trường chỉ áp dụng cho địa chỉ ở Hoa Kỳ cung cấp tín hiệu hữu ích cho biết địa chỉ đó không thể giao hàng và cần được khắc phục. Đối với địa chỉ cần khắc phục, bạn sẽ thấy như sau:
dpvConfirmation
|
N, D hoặc trống.
|
|---|
Để biết thông tin chi tiết về dpvConfirmation, hãy xem
phần Xử lý địa chỉ ở Hoa Kỳ.
Ví dụ về cách khắc phục địa chỉ
Xác nhận địa chỉ
Bạn xác nhận địa chỉ khi kết quả cho biết Address Validation API (API Xác thực địa chỉ) đã suy luận hoặc thay đổi các thành phần địa chỉ để tạo địa chỉ đã xác thực. Trong những trường hợp này, bạn có địa chỉ có thể giao hàng, nhưng muốn chắc chắn hơn rằng địa chỉ kết quả là địa chỉ mà khách hàng muốn.
Để cung cấp lời nhắc chính xác cho khách hàng, logic của bạn sẽ xác định các thành phần được dịch vụ gắn cờ để xác định hành động hoặc cờ mà API áp dụng cho thành phần đó, chẳng hạn như inferred, replaced hoặc spellCorrected.
Xem AddressComponent trong tài liệu tham khảo.
Xác nhận tín hiệu
Address Validation API (API Xác thực địa chỉ) cung cấp một số tín hiệu để cho bạn biết liệu có nên xác nhận địa chỉ hay không.
1. Độ chi tiết của quy trình xác thực
A validationGranularity
của ROUTE trở lên có thể chấp nhận được, nhưng PREMISE hoặc SUBPREMISE
cung cấp tín hiệu mạnh hơn về khả năng giao hàng.
2. Các tín hiệu khác
Khi quyết định xác nhận mục nhập địa chỉ với khách hàng, kết quả cũng cung cấp thông tin sau để xác định các thành phần cần điều tra:
| Dữ liệu được suy luận | Khi trường
hasInferredComponents là true, bạn biết
rằng API đã điền thông tin mà API thu thập được từ các thành phần địa chỉ khác.
|
|---|---|
| Dữ liệu được thay thế | Khi trường
hasReplacedComponents là true, API đã thay thế dữ liệu đã nhập bằng dữ liệu mà API cho là hợp lệ.
|
3. Tín hiệu địa chỉ ở Hoa Kỳ
Một số trường chỉ áp dụng cho địa chỉ ở Hoa Kỳ cho biết rằng logic của bạn sẽ xác nhận thông tin chi tiết với khách hàng. Một trong những điều sau đây được áp dụng:
dpvConfirmation
|
S
Để biết thông tin chi tiết về |
|---|---|
| Phản hồi về địa chỉ | Chứa trường missingComponentTypes có giá trị là
subpremise.
|
Ví dụ về cách xác nhận địa chỉ
Chấp nhận địa chỉ
Bạn chấp nhận địa chỉ khi kết quả cho thấy mức độ tin cậy cao rằng địa chỉ đó có thể giao hàng và có thể được sử dụng mà không cần tương tác thêm với khách hàng trong quy trình tiếp theo.
Chấp nhận tín hiệu
Address Validation API (API Xác thực địa chỉ) cung cấp một số tín hiệu để cho bạn biết liệu có nên xác nhận địa chỉ hay không.
1. Độ chi tiết của quy trình xác thực
validationGranularity là PREMISE trở lên có thể chấp nhận được, nhưng trong một số trường hợp, ROUTE vẫn cho biết địa chỉ có thể giao hàng.
2. Các tín hiệu khác
Kết quả cho địa chỉ chất lượng cao cũng phải cung cấp thông tin sau:
- Không có dữ liệu được thay thế. Trong trường hợp này,
hasReplacedComponents: FALSE. - Không có thành phần được suy luận. Trong trường hợp này,
hasInferredComponents: FALSE.
3. Tín hiệu địa chỉ ở Hoa Kỳ
Một số trường chỉ áp dụng cho địa chỉ ở Hoa Kỳ cho biết địa chỉ chất lượng cao có thể giao hàng. Đối với địa chỉ ở Hoa Kỳ có thể chấp nhận được, bạn sẽ thấy như sau:
dpvConfirmation
|
Y
Để biết thông tin chi tiết về
|
|---|
Ví dụ về cách chấp nhận địa chỉ