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

Tài liệu này mô tả một số trường hợp thực tế mà Address Validation API cung cấp các tín hiệu phản hồi có thể đảm bảo hành vi khắc phục của hệ thống. Xem Ví dụ về quy trình công việc trong phần Xây dựng logic xác thực để biết bối cảnh.

Lưu ý: Các ví dụ ở đây chỉ mang tính minh hoạ và không bao gồm tất cả các trường hợp.

Ví dụ thường gặp: sửa

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 chỉ có địa chỉ đường phố, không có thành phố hoặc mã bưu chính.

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

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,
  "possibleNextAction": "FIX"
}

possibleNextAction cho biết ban đầu rằng có thể không giao được hàng đến địa chỉ này. Các thành phần được làm nổi bật khác cũng hỗ trợ khả năng này, 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"
}

Address Validation API chỉ trả về quốc gia (Hoa Kỳ) dưới dạng CONFIRMED. API này trả về tất cả các thành phần địa chỉ khác dưới 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, bạn có thể nhắc người dùng cung cấp thông tin còn thiếu.

Thiếu số nhà

Ví dụ này cho thấy số nhà bị thiếu.

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

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

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

Một lần nữa, possibleNextAction cho biết ban đầu rằng địa chỉ có thể không gửi được. Ngoài ra, validationGranularity là ROUTE, cho biết có một kết quả trùng khớp với đường phố, nhưng không có đủ thông tin để đến được cơ sở. Ngoài ra, thuộc tính addressComplete bị thiếu trong kết quả, do đó, thuộc tính này 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: Đối với địa chỉ này, bạn có thể 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: sửa

Trong một số trường hợp, việc bạn chỉnh sửa, xác nhận hay chấp nhận một địa chỉ sẽ tuỳ 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 một danh mục lỗi.

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

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

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

Kết quả cho số nhà chưa được xác nhận

Ví dụ dưới đây 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,
  "possibleNextAction": "ACCEPT"
}

Bạn nên xem xét sự kết hợp giữa độ chi tiết xác thực chỉ ở mức độ ước chừng của cơ sở cùng với các thành phần chưa được xác nhận. Một truy vấn về thuộc tính addressComponents cho thấy componentType chưa được xác nhận sau đây:

{
  "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 xác nhận có nghĩa là dịch vụ không thể so khớp số nhà 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 thông tin đầu vào như đã nhập hoặc xác nhận với khách hàng để xác định xem số nhà đã nhập có phải là số nhà dự kiến hay là một lỗi. Câu trả lời của bạn phụ thuộc vào mức độ rủi ro liên quan đến việc phân phối. Xem phần Hướng dẫn triển khai trong phần Tạo logic xác thực.

Thiếu cơ sở phụ

Tình huống này mô tả một địa chỉ chỉ thiếu thông tin về cơ sở phụ, chẳng hạn như số căn hộ hoặc số phòng ban. Nếu không, Address Validation API 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 trong quá trình kiểm tra thủ công kết quả.

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

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

Địa chỉ đã nhập	Khu vực
1 Doctor Carlton B Goodlett Place, San Francisco, CA 94102	USA

Kết quả cho địa điểm phụ bị thiếu

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

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "hasInferredComponents": true,
  "possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}

Một truy vấn address cho thấy những điều sau:

"missingComponentTypes": [
        "subpremise"
      ]

Sau khi tìm hiểu thêm, dữ liệu của USPS cung cấp mã dpvConfirmation là D, mã này cũng cho biết rằng thiếu địa chỉ phụ.

Hành động: Đối với địa chỉ này, bạn có thể nhắc người dùng cung cấp thông tin còn thiếu.