Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

Hướng dẫn về giải pháp xác thực địa chỉ

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

Mục tiêu

Tính năng 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 chính cần xem xét 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ụ: thông tin tổng quan về các sản phẩm tương thích trong một 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ư mức độ tin cậy và độ tin cậy của doanh nghiệp.

Sau khi bạn đã sẵn sàng đánh giá Address Validation API, dưới đây là một số nguyên tắc mà bạn nên áp dụng trong quá trình thử nghiệm.

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 xem Address Validation API có đáp ứng các yêu cầu về giải pháp của bạn hay không, chẳng hạn như:
- Xác định địa chỉ chất lượng tốt.
- Cảnh báo để xử lý 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ả việc 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 thiếu hoặc không chính xác về địa chỉ phụ (chỉ ở Hoa Kỳ).
Đảm bảo bạn sẽ nhận được lợi ích có thể đo lường từ việc 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 nêu trên và xác định xem API 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 thực hiệ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 cho thử nghiệm mà hãy chọn các mẫu ngẫu nhiên đại diện cho những 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 được thực hiện ở Vương quốc Anh so với 30% ở Hoa Kỳ, thì mẫu phải phản ánh tỷ lệ phân chia đó.

Sử dụng địa chỉ từ đ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 có thể được thay thế bằng cách triển khai Address Validation API.

Chuẩn bị cỡ mẫu khoảng 5.000 – 10.000 bản ghi cho thử nghiệm.

Gọi API

Điều kiện tiên quyết của phần này: 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ỉ với API.

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 mỗi 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 đối với trường hợp sử dụng của bạn. 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 tuỳ ý.

Xem lại kết quả

Điều kiện tiên quyết của phần này: 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 đề cập trong tài liệu này

Dữ liệu phản hồi	Định nghĩa	Cách đánh giá	Tính năng này giúp ích như thế nào?
verdict.inputGranularity	Mô tả mức độ chi tiết của địa chỉ đầu vào.	SUB_PREMISE PREMISE PREMISE_PROXIMITY CHẶN ROUTE OTHER	Giú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ả kết quả xác thực tổng thể của địa chỉ.	SUB_PREMISE PREMISE PREMISE_PROXIMITY CHẶN ROUTE OTHER	Giúp bạn xác định chất lượng tổng thể của địa chỉ trong kết quả của API.
verdict.hasInferredComponents	Báo hiệu nếu API đã suy luận ra một thành phần.	Đúng/Sai	API 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	Báo hiệu nếu API đã thay thế một thành phần.	Đúng/Sai	API này 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	Cho biết địa chỉ có đầy đủ hay không.	Đú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 hai để 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ỉ chưa hoàn chỉnh.

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 từ 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ế.

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ỉ được hệ thống của bạn 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ó ở mứ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

Phán quyết

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

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

Bước này là cơ hội để 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 vấn đề về sau 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 nhóm đị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 từ 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.

Xin lưu ý rằng 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 hiệu suất kém của API. API này 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 vấn đề về sau.

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

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

Phán quyết

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

Xem xét các thành phần bị thiếu hoặc chưa được 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 được xác nhận. Đây là một phần của đối tượng Address trong kết quả trả về. Hai trường này là missingComponentTypes và unconfirmedComponentTypes.

Hãy 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ệ, đồng thời thu thập thông tin chính xác cho địa chỉ đó để địa chỉ đó hợp lệ, bằng cách cung cấp 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à một cách mà 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

Phán quyết

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

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ó nội dung chỉnh sửa

Address Validation API có thể chỉnh sửa dữ liệu đầu vào, lấy dữ liệu đầu vào có thể không hợp lệ và xuất ra dữ liệu địa chỉ hợp lệ. Đây là một cách mà 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ử.

Sau đây là các tín hiệu chính cần lưu ý:

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 bài viết 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 chỉnh 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 chỉnh sửa dữ liệu của bạn để giảm bớt trở ngại trong quy trình làm việc sau này hay không.

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ỳ] Xem xét địa chỉ có dữ liệu về căn hộ/phòng bị thiếu hoặc không chính xác

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

Sau đây là các tín hiệu chính cần lưu ý:

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

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

Thử nghiệm 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 thông tin về đị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 đề về sau, đặc biệt là đối với các trường hợp sử dụng liên quan đến việc giao hàng. Address Validation API có thể tăng thêm giá trị gia tăng cho quy trình làm việc của bạn bằng cách xác định sớm vấn đề này, cho phép bạn triển khai các bước để thu thập dữ liệu đã sửa.

Ví dụ: Thiếu số phòng/số căn hộ

Đị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 dữ liệu USPS

"dpvConfirmation": "D"

[Chỉ ở Hoa Kỳ] Xem lại standardizedAddress của USPS

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

Ví dụ: Địa chỉ được tiêu 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 thử nghiệm – hãy bắt đầu thử nghiệm 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à đơn giản hoá hoạt động kinh doanh của bạn. Sau khi làm theo các kịch bản 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 công 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

Hướng dẫn về 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 xét các địa chỉ hợp lệ

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

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

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

Xem xét các thành phần bị thiếu hoặc chưa được 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ó nội dung chỉnh sửa

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

[Chỉ ở Hoa Kỳ] Xem xét địa chỉ có dữ liệu về căn hộ/phòng bị thiếu hoặc không chính xác

Ví dụ: Thiếu số phòng/số căn hộ

[Chỉ ở Hoa Kỳ] Xem lại standardizedAddress của USPS

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

Kết luận

Người đóng góp

Hướng dẫn về giải pháp xác thực địa chỉ