Chọn giải pháp Xác thực địa chỉ

Mục tiêu

Address Validation (Xác thực địa chỉ) mang lại giá trị cho nhiều trường hợp sử dụng và có những yếu tố quan trọng cần cân nhắc ngoài chất lượng thô của kết quả kiểm thử mà bạn nên khám phá. Ví dụ: cái nhìn tổng thể về các sản phẩm tương thích trong luồng người dùng, chẳng hạn như Place Autocomplete và Maps, phạm vi cung cấp theo khu vực, cũng như độ tin cậy và độ tin cậy của doanh nghiệp.

Khi bạn đã đến giai đoạn đánh giá Address Validation API, sau đây là một số nguyên tắc mà bạn nên sử dụng trong quá trình kiểm thử.

Mục tiêu của bài kiểm thử này là:

1. Xác nhận rằng Address Validation API phù hợp với trường hợp sử dụng của bạn.
2. Xác minh cách Address Validation API đáp ứng các yêu cầu về giải pháp của bạn, chẳng hạn như:
   • Xác định các địa chỉ có chất lượng tốt.
   • Cảnh báo về các địa chỉ đầu vào có chất lượng kém.
   • Sửa dữ liệu địa chỉ, bao gồm cả thông tin suy luận, thay thế và sửa lỗi chính tả.
   • Cung cấp địa chỉ được định dạng để vận chuyển.
   • Cảnh báo về dữ liệu phụ bị thiếu hoặc không chính xác (chỉ ở Hoa Kỳ).
3. Đảm bảo bạn sẽ nhận được lợi ích có thể đo lường được khi triển khai API.

Sau khi thực hiện bài kiểm thử, bạn sẽ có thể trả lời các câu hỏi ở trên và xác định xem API này có phù hợp với doanh nghiệp của bạn hay không.

Chuẩn bị dữ liệu của bạn

Bạn nên kiểm thử trên một mẫu dữ liệu địa chỉ hiện có. Đừng chọn dữ liệu theo cách thủ công cho bài kiểm thử, mà hãy chọn các mẫu ngẫu nhiên đại diện cho các khu vực địa lý mà bạn hoạt động. Điều này có nghĩa là nếu bạn hoạt động ở cả Hoa Kỳ và Vương quốc Anh, nhưng 70% hoạt động kinh doanh của bạn diễn ra ở Vương quốc Anh so với 30% ở Hoa Kỳ, thì mẫu này phải phản ánh tỷ lệ đó.

Sử dụng địa chỉ từ thời điểm thu thập. Ví dụ: nếu bạn dự định triển khai tính năng xác thực địa chỉ trong quy trình thanh toán thương mại điện tử, hãy sử dụng địa chỉ do khách hàng nhập trên biểu mẫu, trước khi bất kỳ quy trình xử lý hiện có nào diễn ra có thể được thay thế bằng việc triển khai Address Validation API.

Chuẩn bị mẫu có kích thước khoảng 5.000 – 10.000 bản ghi cho bài kiểm thử.

Gọi API

Điều kiện tiên quyết của phần: Tìm hiểu cách gửi yêu cầu xác thực địa chỉ .

Sau khi chuẩn bị dữ liệu, bạn cần chạy từng bản ghi địa chỉ dựa trên API.

Hãy xem tài liệu về Address Validation API để biết hướng dẫn về cách gọi API. Chúng tôi cũng có một bài viết mô tả các phương pháp hay nhất để sử dụng Address Validation API nhằm xử lý địa chỉ với số lượng lớn.

Kết quả của bước này phải là dữ liệu đầu ra từ API cho từng bản ghi địa chỉ. Sau đó, bạn có thể phân tích kết quả để xác định mức độ phù hợp của API cho trường hợp sử dụng của mình. Bạn có thể sử dụng bảng tính, cơ sở dữ liệu hoặc một công cụ khác.

Xem lại kết quả

Điều kiện tiên quyết của phần: Tìm hiểu cách xử lý phản hồi xác thực, đặc biệt là khái niệm Sửa, Xác nhận và Chấp nhận.

Trong phần này, chúng ta sẽ thảo luận về các trường hợp đầu ra mà bạn có thể phân tích để đánh giá mức độ phù hợp của giải pháp.

Tổng quan về các trường API chính được thảo luận trong tài liệu này

Dữ liệu phản hồi	Đối tượng chung sở thích là gì?	Cách đánh giá	Cách AI trợ giúp
verdict.inputGranularity	Mô tả mức độ chi tiết của địa chỉ đầu vào.	SUB_PREMISE PREMISE PREMISE_PROXIMITY BLOCK ROUTE OTHER	Cho phép bạn xác định xem địa chỉ đầu vào có đủ dữ liệu để có khả năng hợp lệ hay không.
verdict.validationGranularity	Mô tả quy trình xác thực đầu ra tổng thể của địa chỉ.	SUB_PREMISE PREMISE PREMISE_PROXIMITY BLOCK ROUTE OTHER	Cho phép bạn xác định chất lượng tổng thể của địa chỉ trên đầu ra từ API.
verdict.hasInferredComponents	Báo hiệu nếu API đã suy luận một thành phần.	Đúng/Sai	API có thể thêm các thành phần bị thiếu ở những nơi có thể suy luận dữ liệu. Ví dụ: mã Tiểu bang bị thiếu.
verdict.hasReplacedComponents	Báo hiệu nếu API đã thay thế một thành phần.	Đúng/Sai	API có thể thay thế các thành phần không chính xác bằng dữ liệu chính xác trong một số trường hợp.
verdict.addressComplete	Báo hiệu nếu địa chỉ đã hoàn tất.	Đúng/Sai	Nếu API xác định địa chỉ đầu ra có tất cả các thành phần cần thiết, thì giá trị này sẽ là đúng.
address.missingComponentTypes	Báo hiệu để cảnh báo nếu địa chỉ bị thiếu thành phần.	Xem bảng 2 để biết các giá trị.	Đánh dấu các thành phần bị thiếu trong địa chỉ không đầy đủ.

Xem xét các địa chỉ hợp lệ

Sắp xếp dữ liệu được trả về từ API để xác định tập hợp địa chỉ mà hệ thống của bạn sẽ chấp nhận là hợp lệ. Các tín hiệu chính cần tìm trong API là:

• verdict.validationGranularity chứa PREMISE trở lên.
• verdict.addressComplete là true.
• Không có thành phần nào được suy luận hoặc thay thế.

Xem chấp nhận địa chỉ để biết thêm thông tin.

Kết quả của bài tập này phải là một tập hợp con của dữ liệu địa chỉ mà hệ thống của bạn sẽ chấp nhận là hợp lệ. Tại thời điểm này, bạn có thể xác định:

• Tỷ lệ chấp nhận có chấp nhận được không?
• Nếu bạn sử dụng quy trình xác thực địa chỉ hiện có, thì tỷ lệ chấp nhận có tương đương hoặc tốt hơn không?

Ví dụ: Địa chỉ hợp lệ

Địa chỉ đã nhập	Vùng
76 Buckingham Palace Road, London SW1W 9TQ	Vương quốc Anh

Kết quả

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "addressComplete": true
}

Xem xét các địa chỉ không hợp lệ

Bước này là cơ hội để bạn xem xét một số dữ liệu địa chỉ đã được đánh dấu là không hợp lệ theo cách thủ công và xem liệu địa chỉ không hợp lệ đó có thể gây ra các vấn đề ở hạ nguồn hay không nếu không sử dụng Address Validation API.

Sắp xếp dữ liệu được trả về từ API để xác định tập hợp địa chỉ mà hệ thống của bạn sẽ đánh dấu là không hợp lệ. Các tín hiệu chính cần tìm trong API là:

• verdict.validationGranularity được đặt thành OTHER hoặc ROUTE tuỳ thuộc vào mức độ rủi ro của bạn.
• verdict.addressComplete là false.

Xem sửa địa chỉ để biết thêm thông tin.

Kết quả của bài tập này phải là một tập hợp con của dữ liệu địa chỉ mà hệ thống của bạn sẽ đánh dấu là không hợp lệ. Tại thời điểm này, bạn có thể xác định xem tỷ lệ không hợp lệ có chấp nhận được hay không.

Điều quan trọng cần lưu ý là việc đánh dấu địa chỉ là không hợp lệ là một chức năng cốt lõi của Address Validation API và tỷ lệ địa chỉ được đánh dấu là không hợp lệ cao không nhất thiết phản ánh kém về API. API đang cung cấp cho bạn thông tin rằng có vấn đề với địa chỉ và điều này có thể giúp quy trình làm việc của bạn hiệu quả hơn bằng cách phát hiện lỗi sớm hơn, trước khi gây ra các vấn đề ở hạ nguồn.

Ví dụ: Địa chỉ không hợp lệ

Địa chỉ đã nhập	Vùng
21 45 40th street	Hoa Kỳ

Kết quả

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "OTHER",
  "geocodeGranularity": "OTHER",
  "hasUnconfirmedComponents": true
}

Xem xét các thành phần bị thiếu hoặc chưa xác nhận

Ở giai đoạn này, bạn cũng có thể xem xét các thành phần bị thiếu hoặc chưa xác nhận. Đây là một phần của đối tượng Địa chỉ trong kết quả trả về. Hai trường là missingComponentTypes và unconfirmedComponentTypes.

Sử dụng các trường này để giúp phát hiện lý do địa chỉ được API đánh dấu là không hợp lệ và thu thập thông tin chính xác cho địa chỉ để địa chỉ đó có thể hợp lệ, bằng cách gửi lại cho điểm thu thập dữ liệu các trường cụ thể không chính xác. Đây là cách API mang lại giá trị bằng cách cung cấp cho bạn thông tin cụ thể về chất lượng dữ liệu của bạn.

Ví dụ: Thành phần bị thiếu và chưa xác nhận

Địa chỉ đã nhập	Vùng
Fake St, New York, NY 10011	Hoa Kỳ

Kết quả

{
     "inputGranularity": "ROUTE",
     "validationGranularity": "OTHER",
     "geocodeGranularity": "OTHER",
     "hasUnconfirmedComponents": true
}

Thành phần bị thiếu và chưa xác nhận

"missingComponentTypes": [
    "street_number"
],
"unconfirmedComponentTypes": [
    "route"
]

Xem xét các địa chỉ có nội dung sửa

Address Validation API có thể sửa dữ liệu đầu vào, lấy dữ liệu đầu vào địa chỉ có khả năng không hợp lệ và xuất dữ liệu địa chỉ hợp lệ. Đây là một cách API tăng thêm giá trị và bạn cần ghi lại điều này trong quá trình kiểm thử.

Các tín hiệu chính cần tìm là:

• inferred, replaced hoặc spellCorrected được đặt thành true trên bất kỳ addressComponents nào.
• verdict.hasInferredComponentshoặc verdict.hasReplacedComponents được đặt thành true.

Xem xác nhận địa chỉ để biết thêm thông tin.

Kết quả của bài tập này phải là một tập hợp con của dữ liệu địa chỉ đã được API áp dụng nội dung sửa.

Bạn có thể xem xét một phần dữ liệu này theo cách thủ công để xác định xem API có đang sửa dữ liệu của bạn hay không, điều này sẽ giúp giảm bớt sự phức tạp trong quy trình làm việc ở hạ nguồn.

Ví dụ: Địa chỉ có nội dung sửa

Địa chỉ đã nhập	Vùng
76 Bruckingm Palace Road, London SW1W 9TQ	Vương quốc Anh

Route addressComponent

{
    "componentName": {
        "text": "Buckingham Palace Road",
        "languageCode": "en"
    },
    "componentType": "route",
    "confirmationLevel": "CONFIRMED",
    "spellCorrected": true
}

[Chỉ ở Hoa Kỳ] Xem xét địa chỉ có dữ liệu phụ bị thiếu hoặc không chính xác

Address Validation API có thể xác định xem địa chỉ phụ có bị thiếu hoặc không chính xác hay không đối với địa chỉ ở Hoa Kỳ.

Các tín hiệu chính cần tìm là:

• Trong đối tượng Địa chỉ:
  • unconfirmedComponentTypes chứa subpremise
  • missingComponentTypes chứa subpremise
• Trong đối tượng UspsData:
  • dpvConfirmation là D (thiếu địa chỉ phụ)
  • dpvConfirmation là S (chưa xác nhận địa chỉ phụ)

Xem xử lý địa chỉ ở Hoa Kỳ để biết thêm thông tin.

Bài kiểm thử này sẽ cho biết liệu dữ liệu của bạn có vấn đề về địa chỉ phụ bị thiếu hoặc không chính xác, chẳng hạn như số căn hộ hay không. Điều này có thể gây ra các vấn đề ở hạ nguồn, đặc biệt là đối với các trường hợp sử dụng giao hàng. Address Validation API có thể tăng thêm giá trị cho quy trình làm việc của bạn bằng cách xác định vấn đề này sớm hơn, cho phép bạn triển khai các bước để thu thập dữ liệu đã sửa.

Ví dụ: Thiếu địa chỉ phụ

Địa chỉ đã nhập	Vùng
111 8th Avenue, Manhattan, NY 10011	Hoa Kỳ

Thành phần bị thiếu

"missingComponentTypes": [
    "subpremise"
]

Xác nhận DPV dữ liệu USPS

"dpvConfirmation": "D"

[Chỉ ở Hoa Kỳ] Xem xét USPS standardizedAddress

Address Validation API cũng trả về địa chỉ được chuẩn hoá của USPS cho địa chỉ ở Hoa Kỳ. Điều này đặc biệt quan trọng nếu bạn yêu cầu in địa chỉ được định dạng theo USPS trên nhãn vận chuyển.

Bạn có thể xem xét UspsAddress để xem dữ liệu này và xác định xem dữ liệu này có tăng thêm giá trị cho quy trình làm việc của bạn hay không.

Ví dụ: Địa chỉ được chuẩn hoá của USPS

"standardizedAddress": {
    "firstAddressLine": "111 8TH AVE FL 11",
    "cityStateZipAddressLine": "NEW YORK NY 10011-5201",
    "city": "NEW YORK",
    "state": "NY",
    "zipCode": "10011",
    "zipCodeExtension": "5201"
}

Kết luận

Bắt đầu kiểm thử – hãy bắt đầu kiểm thử Address Validation API ngay hôm nay để đảm bảo dữ liệu địa chỉ chính xác, nâng cao trải nghiệm khách hàng và hợp lý hoá hoạt động kinh doanh của bạn. Sau khi làm theo các trường hợp kiểm thử được nêu ở trên, bạn sẽ có thông tin cần thiết để xác định xem Address Validation API có mang lại giá trị cho quy trình làm việc của bạn hay không.

Đề xuất đọc thêm:

• Tài liệu về Address Validation API dành cho nhà phát triển
• Sử dụng Address Validation API để xử lý địa chỉ với số lượng lớn
• Xác thực địa chỉ cho quy trình thanh toán thương mại điện tử

Người đóng góp

Henrik Valve | Kỹ sư DevX