Sửa địa chỉ (ví dụ)

Tài liệu này mô tả một số trường hợp thực tế trong đó API Xác thực địa chỉ cung cấp các tín hiệu phản hồi đảm bảo hành vi khắc phục từ hệ thống của bạn. Các ví dụ ở đây chỉ mang tính minh hoạ và không phải là toàn bộ các trường hợp. Hãy xem phần Tổng quan về quy trình làm việc trong Xây dựng logic xác thực để biết bối cảnh.

Mẹo: Mở bản minh hoạ Xác thực địa chỉ và tự mình thử xác thực các địa chỉ ví dụ.

Ví dụ thường gặp: khắc phục

Phần này mô tả các ví dụ thường gặp trong đó Address Validation API cung cấp các tín hiệu phản hồi cho biết thông tin địa chỉ có chất lượng thấp hơn.

Thiếu thành phố và mã bưu chính

Ví dụ này minh hoạ một mục nhập chỉ có địa chỉ đường phố, không có thành phố hoặc mã bưu chính.

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

Kết quả cho trường hợp thiếu thành phố và mã bưu chính

Ví dụ bên dưới nhấn mạnh các tín hiệu quan trọng trong phản hồi.

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

Các tín hiệu này cho biết địa chỉ không thể giao hàng, vì vậy, bạn có thể truy vấn addressComponents để tìm hiểu thêm:

{
  "componentName": {
    "text": "21",
    "languageCode": "en"
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
  "componentName": {
    "text": "45 40th street",
    "languageCode": "en"
  },
  "componentType": "route",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
  "componentName": {
    "text": "United States",
    "languageCode": "en"
  },
  "componentType": "country",
  "confirmationLevel": "CONFIRMED"
}

API Xác thực địa chỉ chỉ trả về quốc gia (Hoa Kỳ) ở dạng CONFIRMED. API này trả về tất cả các thành phần địa chỉ khác ở dạng UNCONFIRMED_BUT_PLAUSIBLE, với một số thông tin quan trọng bị thiếu trong dữ liệu, chẳng hạn như địa phương và mã bưu chính.

Hành động: Đối với địa chỉ này, hành động được đề xuất là nhắc người dùng cung cấp thông tin còn thiếu.

Thiếu số đường

Ví dụ này cho thấy trường hợp thiếu số đường.

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

Kết quả cho trường hợp thiếu số đường

{
    "inputGranularity": "PREMISE_PROXIMITY",
    "validationGranularity": "ROUTE",
    "geocodeGranularity": "ROUTE"
}

validationGranularity là ROUTE, cho biết kết quả khớp với đường phố, nhưng không có đủ thông tin để đến địa điểm. Ngoài ra, thuộc tính addressComplete bị thiếu trong kết quả và do đó, giá trị là false. Một truy vấn khác về đối tượng address cho thấy một loại thành phần bị thiếu:

"missingComponentTypes": [
        "street_number"
      ]

Hành động: Trong trường hợp này, bạn nên nhắc người dùng cung cấp thông tin còn thiếu.

Ví dụ về trường hợp đặc biệt: khắc phục

Trong một số trường hợp, việc bạn khắc phục, xác nhận hay chấp nhận một địa chỉ sẽ phụ thuộc vào trường hợp kinh doanh cụ thể của bạn. Các ví dụ bên dưới minh hoạ những trường hợp có thể không hoàn toàn thuộc danh mục khắc phục.

Số đường chưa được xác nhận

Trong trường hợp này, API Xác thực địa chỉ không thể xác nhận số đường được cung cấp, nhưng cho biết địa chỉ đã hoàn tất.

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

Kết quả cho trường hợp số đường chưa được xác nhận

Ví dụ bên dưới nhấn mạnh các tín hiệu quan trọng.

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

Bạn nên điều tra sự kết hợp của mức độ chi tiết xác thực chỉ ở mức gần đúng về địa điểm cùng với các thành phần chưa được xác nhận. Truy vấn thuộc tính addressComponents cho thấy componentType chưa được xác nhận sau:

{
  "componentName": {
    "text": "84",
    "languageCode": "en"
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}

Ở đây, confirmation_level của street_number được đặt thành UNCONFIRMED_BUT_PLAUSIBLE. Chưa được xác nhận có nghĩa là dịch vụ không thể khớp số đường 84 trong tập dữ liệu của mình và có thể có nghĩa là dữ liệu thành phần vẫn có thể hợp lệ.

Hành động: Bạn có thể chấp nhận dữ liệu đầu vào như đã nhập hoặc xác nhận với khách hàng để xác định xem số đường đã nhập là cố ý hay do lỗi. Phản hồi của bạn phụ thuộc vào mức độ rủi ro liên quan đến việc giao hàng. Hãy xem phần Hướng dẫn triển khai trong Xây dựng logic xác thực.

Thiếu địa điểm phụ

Trường hợp này mô tả một địa chỉ chỉ thiếu địa điểm phụ, chẳng hạn như số căn hộ hoặc số phòng ban. Nếu không, API Xác thực địa chỉ có thể xác thực đầy đủ địa chỉ. Như trường hợp khi thiếu bất kỳ thành phần địa chỉ nào, addressComplete là false và do đó không xuất hiện khi kiểm tra kết quả theo cách thủ công.

Lưu ý: Ở một số quốc gia, Address Validation API không thể phát hiện địa điểm phụ bị thiếu; trong khi ở Hoa Kỳ, SUB_PREMISE bị thiếu cho biết địa chỉ không thể giao hàng.

Để minh hoạ, giả sử một khách hàng nhập một địa chỉ hợp lệ cho văn phòng thẩm định viên của thành phố San Francisco, nhưng bỏ sót số phòng trong dữ liệu đầu vào.

Địa chỉ đã nhập	Vùng
1 Doctor Carlton B Goodlett Place, San Francisco, CA 94102	Hoa Kỳ

Kết quả cho trường hợp thiếu địa điểm phụ

Trong ví dụ này, kết quả không hiển thị thuộc tính addressComplete, vì vậy, giá trị là false. Do đó, bạn biết rằng ít nhất một thành phần địa chỉ là không mong muốn, chưa được giải quyết hoặc bị thiếu.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "hasInferredComponents": true

}

Truy vấn address cho thấy những nội dung sau:

"missingComponentTypes": [
        "subpremise"
      ]

Khi tìm hiểu thêm, dữ liệu USPS cung cấp mã dpvConfirmation là D, cũng cho biết địa điểm phụ bị thiếu.

Hành động: Đối với địa chỉ này, hành động được đề xuất là nhắc người dùng cung cấp thông tin còn thiếu.