Chấp nhận địa chỉ – ví dụ

Tài liệu này mô tả một số trường hợp thực tế mà 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 chấp nhận từ hệ thống của bạn. 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.

Ví dụ thường gặp: chấp nhận

Trường hợp này minh hoạ một địa chỉ mà hệ thống của bạn sẽ chấp nhận địa chỉ do khách hàng nhập.

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

Kết quả cho một địa chỉ hợp lệ

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

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

Ngoài ra, phản hồi còn cho biết những điều sau:

  • hasUnconfirmedComponents vẫn còn false
  • hasInferredComponents vẫn còn false
  • hasReplacedComponents vẫn còn false
  • hasSpellCorrectedComponents vẫn còn false

Khi kết hợp với nhau, những tín hiệu này cho thấy một địa chỉ chất lượng cao.

Ví dụ về trường hợp đặc biệt: chấp nhận

Các ví dụ sau đây đề cập đến những trường hợp mà verdict cho biết địa chỉ có vấn đề về chất lượng cần được điều tra thêm. Những 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.

Số đường phố chưa được xác nhận ở bên ngoài Hoa Kỳ

Ví dụ này minh hoạ việc nhập một địa chỉ ở Ý có tất cả các thành phần địa chỉ, cùng với việc không có thành phần nào được suy luận hoặc thay thế. Tuy nhiên, validationGranularity là ROUTE.

Địa chỉ đã nhập Khu vực
Via Fonte Grugnale, 14 unit 2, 66054 Vasto CH, Italia IT

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

{
  "inputGranularity": "SUB_PREMISE",
  "validationGranularity": "ROUTE",
  "geocodeGranularity": "ROUTE",
  "addressComplete": true,
  "hasUnconfirmedComponents": true
}

Sau khi điều tra thêm về các thành phần địa chỉ, chúng tôi nhận thấy số nhà là UNCONFIRMED_BUT_PLAUSIBLE.

{
   "text": "14",
   "componentType": "street_number",
   "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}

Số nhà chưa được xác nhận ở Hoa Kỳ

Ví dụ này minh hoạ việc nhập một địa chỉ ở Hoa Kỳ có tất cả các thành phần địa chỉ, không có thành phần nào được suy luận hoặc thay thế. Tuy nhiên, validationGranularity là PREMISE_PROXIMITY.

Địa chỉ đã nhập Khu vực
975 Carson Dr, Sunnyvale, CA 94086 Hoa Kỳ

Dữ liệu của USPS cho số đường chưa được xác nhận

{
   "firstAddressLine": "975 CARSON DR",
   "cityStateZipAddressLine": "SUNNYVALE CA 94086",
   "city": "SUNNYVALE",
   "state": "CA",
   "zipCode": "94086"
   "dpvConfirmation": "N",
   "dpvFootnote": "AAM3",
   "carrierRoute": "C031",
   "carrierRouteIndicator": "D",
   "postOfficeCity": "SUNNYVALE",
   "postOfficeState": "CA",
   "fipsCountyCode": "085",
   "county": "SANTA CLARA",
}

Dữ liệu không đầy đủ của USPS cho một địa chỉ đã xác nhận

Ví dụ này minh hoạ việc nhập một địa chỉ ở Hoa Kỳ với tất cả các thành phần địa chỉ đã được xác nhận, không có thành phần nào được suy luận hoặc thay thế và validationGranularity là PREMISE. Tuy nhiên, uspsData chưa được điền đầy đủ và không chứa giá trị dpvConfirmation.

Địa chỉ đã nhập Khu vực
155 Via Condado Way, Palm Beach Gardens, FL 33418-1703 Hoa Kỳ

Kết quả cho một địa chỉ đã xác nhận nhưng có dữ liệu không đầy đủ của USPS

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

Dữ liệu của USPS cho một địa chỉ đã xác nhận nhưng dữ liệu của USPS chưa đầy đủ

{
  "standardizedAddress": {
    "firstAddressLine": "155 VIA CONDADO WAY",
    "cityStateZipAddressLine": "PALM BEACH GARDENS",
    "city": "PALM BEACH GARDENS",
    "state": "FL",
    "zipCode": "33418"
  },
  "carrierRoute": "H018",
  "postOfficeCity": "PALM BEACH GARDENS",
  "postOfficeState": "FL"
}