Trang này được dịch bởi Cloud Translation API.

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

Sơ đồ quy trình cho thấy thông tin tổng quan cấp cao về các bước kiểm thử.

Mục tiêu

Dịch vụ 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 điểm cần cân nhắc chính 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ụ: chế độ xem tổng quan về các sản phẩm tương thích trong một quy trình của người dùng, chẳng hạn như Tính năng tự động hoàn thành địa điểm và Maps, phạm vi cung cấp theo khu vực và độ tin cậy và độ tin cậy của doanh nghiệp.

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

Mục tiêu của thử nghiệm này là:

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.
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 địa chỉ có chất lượng tốt.
- Cảnh báo để giải quyết những thông tin đầu vào có chất lượng kém.
- Chỉnh sửa dữ liệu địa chỉ, bao gồm cả suy luận, thay thế và sửa lỗi chính tả.
- Cung cấp địa chỉ giao hàng theo định dạng.
- Cảnh báo về dữ liệu phụ thuộc bị thiếu hoặc không chính xác (chỉ ở Hoa Kỳ).
Đả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 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ử dựa 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 thử nghiệm, 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 phải phản ánh tỷ lệ đó.

Sử dụng địa chỉ tại thời điểm chụp. Ví dụ: nếu bạn đang lên kế hoạch triển khai tính năng xác thực địa chỉ trong quy trình thanh toán của trang 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 có bất kỳ quy trình xử lý hiện có nào có thể được thay thế bằng cách triển khai Address Validation API.

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

Gọi API

Điều kiện tiên quyết của phần: 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 sẽ 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 này. 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: Hiểu cách xử lý phản hồi xác thực, đặc biệt là khái niệm về Khắc phục, 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 đề cập trong tài liệu này

Dữ liệu phản hồi	Đó là gì?	Cách đánh giá	Tính năng này giúp ích như thế nào?
verdict.inputGranularity	Mô tả độ chi tiết đầu vào của địa chỉ.	SUB_PREMISE PREMISE PREMISE_PROXIMITY CHẶN ROUTE KHÁC	Cho phép bạn xác định xem địa chỉ đầu vào có đủ dữ liệu để có thể 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 CHẶN ROUTE KHÁC	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 ra một thành phần.	Đúng/Sai	API này có thể thêm các thành phần bị thiếu khi có thể suy luận dữ liệu. Ví dụ: thiếu mã tiểu bang.
verdict.hasReplacedComponents	Đưa ra tín hiệu nếu API đã thay thế một thành phần.	Đúng/Sai	Trong một số trường hợp, 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.
verdict.addressComplete	Cho biết địa chỉ đã hoàn tất hay chưa.	Đú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à true.
address.missingComponentTypes	Tín hiệu cảnh báo nếu địa chỉ thiếu thành phần.	Xem bảng 2 để biết các giá trị.	Làm nổi bật các thành phần bị thiếu trong một địa chỉ không đầy đủ.

Xem lại các địa chỉ hợp lệ

Sắp xếp dữ liệu mà API trả về để 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 đoán hoặc thay thế.

Hãy xem phần 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ệ. Ở bước 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 cao hơn không?

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

Địa chỉ đã nhập	Khu vực
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 thủ công một số dữ liệu địa chỉ đã được đánh dấu là không hợp lệ và xem liệu địa chỉ không hợp lệ đó có thể gây ra các vấn đề tiếp theo hay không mà không cần sử dụng Address Validation API.

Sắp xếp dữ liệu mà API trả về để 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.

Hãy xem bài viết 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ệ phần trăm 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 phần 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 hiệu suất kém của API. API này cung cấp cho bạn thông tin rằng địa chỉ có vấn đề. Đ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 đề sau này.

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

Địa chỉ đã nhập	Khu vực
21 45 40th street	USA

Kết quả

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

Kiểm tra các thành phần bị thiếu hoặc chưa xác nhận

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

Sử dụng các trường này để giúp phát hiện lý do API đánh dấu một địa chỉ 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(các) trường cụ thể không chính xác cho điểm thu thập dữ liệu. Đâ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.

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

Địa chỉ đã nhập	Khu vực
Fake St, New York, NY 10011	USA

Kết quả

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

Các thành phần bị thiếu và chưa được xác nhận

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

Xem lại địa chỉ đã được chỉnh 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ó thể không hợp lệ và xuất dữ liệu địa chỉ hợp lệ. Đây là một cách mà API mang lại giá trị và bạn cần nắm bắt được điều này trong quá trình kiểm thử.

Sau đây là những tín hiệu chính cần tìm:

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

Hãy xem phần 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 một bản sửa lỗi.

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 điều chỉnh dữ liệu của bạn hay không. Việc này sẽ giúp giảm bớt khó khăn trong quy trình công việc tiếp theo.

Ví dụ: Địa chỉ có thông tin chỉnh sửa

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

Tuyến đường addressComponent

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

[Chỉ ở Hoa Kỳ] Kiểm tra địa chỉ thiếu hoặc có dữ liệu không chính xác về địa điểm phụ

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

Sau đây là những tín hiệu chính cần tìm:

Trong đối tượng Address:
- unconfirmedComponentTypes chứa subpremise
- missingComponentTypes chứa subpremise
Trong đối tượng UspsData:
- dpvConfirmation là D (thiếu cơ sở phụ)
- dpvConfirmation là S (chưa xác nhận cơ sở phụ)

Hãy xem phần xử lý địa chỉ ở Hoa Kỳ để biết thêm thông tin.

Bài kiểm tra này sẽ cho biết liệu dữ liệu của bạn có vấn đề về việc thiếu hoặc sai địa điểm phụ (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 đề tiếp theo, đặc biệt là đối với các trường hợp sử dụng dịch vụ 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 điều này sớm hơn, cho phép bạn triển khai các bước để thu thập dữ liệu đã được sửa.

Ví dụ: Thiếu cơ sở phụ

Địa chỉ đã nhập	Khu vực
111 8th Avenue, Manhattan, NY 10011	Hoa Kỳ

Thiếu thành phần

"missingComponentTypes": [
    "subpremise"
]

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

"dpvConfirmation": "D"

[Chỉ ở Hoa Kỳ] Kiểm tra địa chỉ chuẩn hoá của USPS

Address Validation API cũng trả về địa chỉ chuẩn hoá của USPS cho các địa chỉ tại Hoa Kỳ. Điều này đặc biệt quan trọng nếu bạn yêu cầu in địa chỉ theo định dạng 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ó mang lại giá trị cho quy trình làm việc của bạn hay không.

Ví dụ: Địa chỉ được tiêu chuẩn hoá theo 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 của khách hàng và đơn giản hoá các hoạt động kinh doanh của bạn. Sau khi làm theo các tình huống kiểm thử 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.

Tài liệu đọc thêm được đề xuất:

Người đóng góp

Henrik Valve | Kỹ sư DevX

Chọn giải pháp Xác thực địa chỉ Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Mục tiêu

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

Gọi API

Xem lại kết quả

Xem lại các địa chỉ hợp lệ

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

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

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

Kiểm tra các thành phần bị thiếu hoặc chưa xác nhận

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

Xem lại địa chỉ đã được chỉnh sửa

Ví dụ: Địa chỉ có thông tin chỉnh sửa

[Chỉ ở Hoa Kỳ] Kiểm tra địa chỉ thiếu hoặc có dữ liệu không chính xác về địa điểm phụ

Ví dụ: Thiếu cơ sở phụ

[Chỉ ở Hoa Kỳ] Kiểm tra địa chỉ chuẩn hoá của USPS

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

Kết luận

Người đóng góp

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