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 các tín hiệu phản hồi đảm bảo hành vi thêm địa điểm phụ từ hệ thống của bạn. Các tín hiệu này chỉ áp dụng cho địa chỉ ở Hoa Kỳ. Hãy xem Ví dụ về quy trình làm việc 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 cơ sở phụ

Tình huống này minh hoạ một địa chỉ mà hệ thống 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 làm nổi 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 đặc biệt: thêm cơ sở phụ

Ví dụ sau đây đề cập đến trường hợp verdict cho biết các 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 nâng cao logic hệ thống.

Thiếu các cơ sở phụ và các 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ỳ nhưng thiếu thông tin về đị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ỳ

Kết quả cho một cơ sở 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"
}

Việc điều tra thêm các thành phần địa chỉ cho thấy rằng đị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
}