Sử dụng API Xác thực địa chỉ để xử lý các địa chỉ ở khối lượng lớn

Mục tiêu

Là nhà phát triển, bạn thường làm việc với các tập dữ liệu chứa địa chỉ khách hàng có thể không có chất lượng tốt. Bạn cần đảm bảo rằng địa chỉ của trường hợp sử dụng khác nhau, từ xác minh mã khách hàng, đến giao hàng, v.v.

Xác thực địa chỉ API là một sản phẩm của Nền tảng Google Maps mà bạn có thể dùng để xác thực một địa chỉ. Tuy nhiên, điều này chỉ xử lý một địa chỉ tại một thời điểm. Trong tài liệu này, chúng ta sẽ xem xét cách sử dụng xác thực địa chỉ khối lượng lớn trong nhiều tình huống, từ kiểm thử API sang xác thực địa chỉ một lần và định kỳ.

Trường hợp sử dụng

Bây giờ, chúng ta sẽ hiểu các trường hợp sử dụng trong đó Xác thực địa chỉ khối lượng cao là hữu ích.

Thử nghiệm

Bạn thường muốn kiểm thử Address Validation API (API Xác thực địa chỉ) bằng cách chạy hàng nghìn của bạn. Bạn có thể có địa chỉ trong tệp Giá trị được phân tách bằng dấu phẩy và muốn để xác thực chất lượng của địa chỉ.

Xác thực địa chỉ một lần

Trong khi làm quen với API Xác thực địa chỉ, bạn nên xác thực cơ sở dữ liệu địa chỉ hiện có dựa vào cơ sở dữ liệu người dùng.

Xác thực định kỳ các địa chỉ

Có một số trường hợp cần xác thực địa chỉ định kỳ:

  • Bạn có thể đã lên lịch cho các công việc để xác thực các địa chỉ cho chi tiết được ghi lại trong ngày, ví dụ: từ lượt đăng ký của khách hàng, chi tiết đơn đặt hàng, giao hàng lịch biểu.
  • Bạn có thể nhận được tệp kết xuất dữ liệu chứa địa chỉ từ các phòng ban khác nhau, ví dụ: từ bán hàng đến tiếp thị. Bộ phận mới nhận thường muốn xác thực chúng trước khi sử dụng.
  • Bạn có thể thu thập địa chỉ trong các cuộc khảo sát hoặc trong nhiều chương trình khuyến mãi và sau đó cập nhật trong hệ thống trực tuyến. Bạn muốn xác thực rằng các địa chỉ này chính xác khi nhập chúng vào hệ thống.

Tìm hiểu chuyên sâu về kỹ thuật

Trong phạm vi của tài liệu này, chúng tôi giả định rằng:

  • Bạn đang gọi API xác thực địa chỉ bằng địa chỉ của một khách hàng cơ sở dữ liệu (ví dụ: một cơ sở dữ liệu có thông tin về khách hàng)
  • Bạn có thể lưu các cờ về tính hợp lệ vào bộ nhớ đệm đối với các địa chỉ riêng lẻ trong cơ sở dữ liệu của mình.
  • Cờ về tính hợp lệ được truy xuất từ API Xác thực địa chỉ khi một đăng nhập của khách hàng cá nhân.

Bộ nhớ đệm để dùng cho phiên bản phát hành công khai

Khi sử dụng API xác thực địa chỉ, bạn thường muốn lưu vào bộ nhớ đệm một số phần của phản hồi từ lệnh gọi API. Mặc dù Điều khoản Giới hạn dịch vụ dữ liệu nào có thể được lưu vào bộ nhớ đệm, mọi dữ liệu có thể được lưu vào bộ nhớ đệm từ API xác thực địa chỉ phải được lưu vào bộ nhớ đệm đối với tài khoản người dùng. Điều này có nghĩa là trong cơ sở dữ liệu, của người dùng, hoặc siêu dữ liệu địa chỉ phải được lưu vào bộ nhớ đệm đối với địa chỉ email của người dùng hoặc mã nhận dạng chính khác.

Đối với trường hợp sử dụng Xác thực địa chỉ khối lượng lớn, việc lưu dữ liệu vào bộ nhớ đệm phải tuân theo API xác thực địa chỉ Dành riêng cho dịch vụ Điều khoản, nêu trong Mục 11.3. Dựa trên thông tin này, bạn sẽ có thể xác định xem địa chỉ của người dùng có hợp lệ hay không. Trong trường hợp này, bạn sẽ nhắc cho người dùng một địa chỉ đã sửa trong lần tương tác tiếp theo của họ với .

  • Dữ liệu từ AddressComponent đối tượng
    • confirmationLevel
    • inferred
    • spellCorrected
    • replaced
    • unexpected

Nếu bạn muốn lưu vào bộ nhớ đệm bất kỳ thông tin nào về địa chỉ thực tế, thì dữ liệu đó chỉ được lưu vào bộ nhớ đệm khi có sự đồng ý của người dùng. Điều này giúp đảm bảo người dùng vẫn khoẻ tại sao một dịch vụ cụ thể lại lưu trữ địa chỉ của họ và họ đồng ý với về việc chia sẻ địa chỉ.

Một ví dụ về sự đồng ý của người dùng: lượt tương tác trực tiếp với một địa chỉ thương mại điện tử trên trang thanh toán. Chúng tôi hiểu rằng bạn sẽ lưu vào bộ nhớ đệm xử lý địa chỉ cho mục đích vận chuyển gói hàng.

Khi có sự đồng ý của người dùng, bạn có thể lưu formattedAddress và các thành phần chính khác vào bộ nhớ đệm khỏi câu trả lời. Tuy nhiên, trong trường hợp không có giao diện người dùng, người dùng không thể cung cấp vì quá trình xác thực địa chỉ diễn ra từ phần phụ trợ. Do đó, bạn có thể lưu rất ít thông tin vào bộ nhớ đệm trong trường hợp không có giao diện người dùng này.

Tìm hiểu câu trả lời

Nếu phản hồi của API xác thực địa chỉ chứa các điểm đánh dấu sau đây, thì bạn có thể tự tin rằng địa chỉ đầu vào có chất lượng giao hàng được:

  • Điểm đánh dấu addressComplete trong Kết quả đối tượng là true,
  • validationGranularity trong Kết quả đối tượng là PREMISE hoặc SUB_PREMISE
  • Không có AddressComponent nào được đánh dấu là:
    • Inferred(Lưu ý: inferred=truecó thể xảy ra khi addressComplete=true)
    • spellCorrected
    • replaced
    • unexpected
  • confirmationLevel: Mức độ xác nhận trên AddressComponent được đặt thànhCONFIRMEDhoặcUNCONFIRMED_BUT_PLAUSIBLE

Nếu phản hồi của API không chứa các mã đánh dấu ở trên, thì địa chỉ đầu vào có thể có chất lượng kém và bạn có thể lưu cờ vào bộ nhớ đệm trong cơ sở dữ liệu để phản ánh thực hiện việc đó. Cờ lưu trong bộ nhớ đệm chỉ ra rằng toàn bộ địa chỉ có chất lượng kém, trong khi cờ chi tiết hơn, chẳng hạn như Đã sửa lỗi chính tả cho biết loại cụ thể của giải quyết vấn đề về chất lượng. Vào lần tiếp theo khách hàng tương tác với một địa chỉ bị gắn cờ bạn có thể gọi API Xác thực địa chỉ bằng của bạn. API Xác thực địa chỉ sẽ trả về địa chỉ mà bạn đã sửa có thể hiển thị bằng lời nhắc trên giao diện người dùng. Sau khi khách hàng chấp nhận địa chỉ đã định dạng bạn có thể lưu những nội dung sau vào bộ nhớ đệm của phản hồi:

  • formattedAddress
  • postalAddress
  • addressComponent componentNameshoặc
  • UspsData standardizedAddress

Triển khai quy trình xác thực Địa chỉ không có giao diện người dùng

Dựa trên nội dung thảo luận ở trên:

  • Thông thường, bạn cần lưu một số phần của phản hồi trong địa chỉ vào bộ nhớ đệm Validation API (API Xác thực) dành cho doanh nghiệp.
  • Tuy nhiên, Điều khoản Dịch vụ ở Nền tảng Google Maps hạn chế loại dữ liệu có thể được lưu vào bộ nhớ đệm.

Trong phần sau, chúng tôi sẽ thảo luận quy trình hai bước về cách tuân thủ Điều khoản dịch vụ và triển khai xác thực địa chỉ với khối lượng lớn.

Bước 1:

Ở bước đầu tiên, chúng ta sẽ xem xét cách triển khai địa chỉ khối lượng lớn tập lệnh xác thực từ một quy trình dữ liệu hiện có. Quá trình này sẽ cho phép bạn lưu trữ các trường cụ thể từ phản hồi của API xác thực địa chỉ trong Điều khoản Tuân thủ dịch vụ.

Biểu đồ A: Sơ đồ dưới đây thể hiện cách nâng cao một quy trình dữ liệu với logic Xác thực địa chỉ khối lượng lớn.

alt_text

Theo Điều khoản dịch vụ, bạn có thể lưu vào bộ nhớ đệm các dữ liệu sau từ addressComponent:

  • confirmationLevel
  • inferred
  • spellCorrected
  • replaced
  • unexpected

Do đó, trong bước triển khai này, chúng tôi sẽ lưu vào bộ nhớ đệm những nội dung nêu trên so với UserID.

Để biết thêm thông tin, hãy xem chi tiết về dữ liệu thực tế cấu trúc.

Bước 2:

Ở bước 1, chúng tôi đã thu thập ý kiến phản hồi rằng một số địa chỉ trong tập dữ liệu đầu vào có thể đạt được chất lượng cao. Trong bước tiếp theo, chúng tôi sẽ xử lý các địa chỉ bị gắn cờ này đồng thời trình bày cho người dùng và xin phép họ để chỉnh sửa dữ liệu đã lưu trữ của bạn.

Biểu đồ B: Sơ đồ này thể hiện cách người dùng tích hợp hai đầu quy trình đồng ý có thể diễn ra như sau:

alt_text

  1. Khi người dùng đăng nhập, trước tiên, hãy kiểm tra xem bạn có lưu bất kỳ cờ xác thực nào vào bộ nhớ đệm hay không trong hệ thống của bạn.
  2. Nếu có cờ, bạn nên hiển thị cho người dùng giao diện người dùng để sửa và cập nhật địa chỉ của họ.
  3. Bạn có thể gọi lại API Xác thực địa chỉ bằng và hiển thị địa chỉ đã sửa cho người dùng để xác nhận.
  4. Nếu địa chỉ có chất lượng tốt, Address Validation API (API Xác thực địa chỉ) sẽ trả về một formattedAddress.
  5. Bạn có thể hiển thị địa chỉ đó cho người dùng nếu nội dung chỉnh sửa đã được chỉnh sửa hoặc im lặng chấp nhận nếu không có sửa đổi.
  6. Sau khi người dùng chấp nhận, bạn có thể lưu formattedAddress vào bộ nhớ đệm trong cơ sở dữ liệu.

Kết luận

Xác thực địa chỉ khối lượng lớn là một trường hợp sử dụng phổ biến mà bạn có thể gặp phải trong nhiều ứng dụng. Tài liệu này cố gắng minh hoạ một số tình huống và mẫu thiết kế về cách triển khai giải pháp như vậy sao cho phù hợp với Google Maps Điều khoản dịch vụ của Nền tảng.

Chúng tôi đã viết thêm việc triển khai tham chiếu của Địa chỉ khối lượng lớn Xác thực dưới dạng một thư viện nguồn mở trên GitHub. Hãy dùng thử để bắt đầu bằng tính năng Xác thực địa chỉ số lượng lớn một cách nhanh chóng. Ngoài ra, hãy xem bài viết về các mẫu thiết kế về cách sử dụng thư viện trong nhiều tình huống.

Các bước tiếp theo

Tải bài viết Cải thiện quy trình thanh toán, giao hàng và hoạt động với địa chỉ đáng tin cậy Sách trắng và xem Cải thiện quy trình thanh toán, giao hàng và hoạt động bằng Địa chỉ Xác nhận kết quả Hội thảo trên web.

Bạn nên đọc thêm:

Người đóng góp

Google duy trì bài viết này. Những cộng tác viên sau đây là người viết bài đầu tiên.
Tác giả chính:

Henrik Valve | Kỹ sư giải pháp
Thomas Anglaret | Giải pháp Kỹ sư
Sarthak Ganguly | Giải pháp Kỹ sư