Thêm địa điểm phụ vào địa chỉ – ví dụ (chỉ ở Hoa Kỳ)

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 tín hiệu phản hồi đảm bảo hành vi thêm cơ sở phụ từ hệ thống của bạn. Những tín hiệu này chỉ áp dụng cho địa chỉ ở Hoa Kỳ. Hãy xem Quy trình công việc mẫu trong phần Xây dựng logic xác thực để biết bối cảnh.

Ví dụ thường gặp: thêm địa điểm phụ

Trường hợp này minh hoạ một địa chỉ mà hệ thống của bạn có thể nhắc khách hàng thêm số căn hộ vào địa chỉ.

Địa chỉ đã nhập Khu vực
1450 Brickell Avenue, Miami, FL 33131-4065 Hoa Kỳ

Kết quả cho một địa chỉ thiếu thông tin về cơ sở phụ

Ví dụ dưới đây nêu bật tín hiệu quan trọng.

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

Ví dụ về trường hợp hiếm gặp: thêm địa chỉ phụ

Ví dụ sau đây trình bày một trường hợp trong đó verdict cho biết vấn đề về chất lượng địa chỉ cần được điều tra thêm. Ví dụ này cũng minh hoạ cách logic của bạn có thể chuyển từ kết quả sang các thành phần địa chỉ để có được thông tin đầy đủ hơn nhằm cải thiện logic hệ thống.

Thiếu thành phần phụ và thành phần được suy luận và thay thế

Ví dụ này minh hoạ việc nhập một địa chỉ ở Hoa Kỳ bị thiếu địa phương và mã bưu chính không chính xác.

Địa chỉ đã nhập Khu vực
1450 Brickell Avenue, FL 33132-4065 Hoa Kỳ

Phán quyết về một thành phần phụ bị thiếu và các thành phần được suy luận và thay thế

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

Khi điều tra thêm về các thành phần địa chỉ, chúng tôi nhận thấy địa phương đã được suy luận và mã bưu chính đã được thay thế.

{
   "componentName": {
     "text": "33131",
   }
   "componentType": "postal_code",
   "confirmationLevel": "CONFIRMED",
   "replaced": true
},
{
   "componentName": {
     "text": "Miami",
     "languageCode": "en"
   }
   "componentType": "locality",
   "confirmationLevel": "CONFIRMED",
   "inferred": true
}