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

Tài liệu này mô tả một số tình huống 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. Xem phần Tổng quan về quy trình công việc trong phần Tạo logic xác thực để biết ngữ cảnh.

Lưu ý: các ví dụ ở đây chỉ mang tính minh hoạ chứ không phải là toàn bộ các trường hợp.

Ví dụ phổ biến: sửa

Phần này mô tả các ví dụ phổ biến trong đó API Xác thực địa chỉ cung cấp 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	Khu vực
21 45 40th street	USA

Kết quả khi 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 từ phản hồi.

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

Những tín hiệu này cho biết địa chỉ không gửi được, 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. Phương thức 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ành phần quan trọng bị thiếu trong dữ liệu, chẳng hạn như địa phương và mã bưu chính.

Thao tác: Đối với địa chỉ này, bạn nên 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 địa chỉ thiếu số nhà.

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

Kết quả về việc thiếu số nhà

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

validationGranularity là ROUTE, cho biết có trùng khớp với đường phố, nhưng không đủ thông tin để đến địa điểm. Ngoài ra, kết quả còn thiếu thuộc tính addressComplete, do đó kết quả 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"
      ]

Thao tác: 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 hiếm gặp: khắc phục

Trong một số trường hợp, việc bạn sửa, xác nhận hay chấp nhận đị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ạ các trường hợp có thể không hoàn toàn thuộc danh mục bản sửa lỗi.

Số nhà 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à đã cung cấp, nhưng cho biết địa chỉ đã hoàn chỉnh.

Đị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 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
}

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

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

Tại đây, confirmation_level của street_number được đặt thành UNCONFIRMED_BUT_PLAUSIBLE. Unconfirmed (Chưa xác nhận) có nghĩa là dịch vụ không khớp với số nhà 84 trong tập dữ liệu của dịch vụ đó và plausible (có thể xảy ra) có nghĩa là dữ liệu thành phần vẫn có thể hợp lệ.

Thao tác: Bạn có thể chấp nhận giá trị nhập vào hoặc xác nhận với khách hàng để xác định xem số nhà đã nhập là cố ý hay nhầm lẫn. Phản hồi của bạn phụ thuộc vào mức độ rủi ro liên quan đến đơn hàng của bạn. Xem Hướng dẫn triển khai trong phần Tạo logic xác thực.

Thiếu tiền đề phụ

Tình huống này mô tả một địa chỉ chỉ thiếu cơ sở 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ỉ. Trong trường hợp thiếu bất kỳ thành phần địa chỉ nào, addressComplete sẽ 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, API Xác thực địa chỉ không thể phát hiện trường hợp thiếu địa điểm phụ; trong khi ở Hoa Kỳ, trường hợp thiếu SUB_PREMISE cho biết địa chỉ không gửi được.

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

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

Kết quả về việc thiếu tiền đề phụ

Trong ví dụ này, kết quả không hiển thị thuộc tính addressComplete, vì vậy kết quả là false. Do đó, bạn biết rằng ít nhất một phần tử địa chỉ là 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

}

Truy vấn address cho thấy những thông tin sau:

"missingComponentTypes": [
        "subpremise"
      ]

Sau khi tìm hiểu thêm, dữ liệu của USPS cung cấp mã dpvConfirmation là D, cũng cho biết thiếu cơ sở phụ.

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