Chấp nhận đị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 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. Vui lòng xem phần Tổng quan về quy trình công việc trong bài viết Sử dụng phản hồi xác thực để nắm được ngữ cảnh.

Ví dụ phổ biến: chấp nhận

Tình huống này minh hoạ một địa chỉ mà trong đó hệ thống của bạn sẽ chấp nhận địa chỉ do khách hàng nhập.

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

Kết quả cho địa chỉ có thể chấp nhận

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

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

Ví dụ về trường hợp hiếm gặp: chấp nhận

Các ví dụ sau đây đề cập đến những tình huống mà verdict chỉ ra các vấn đề về chất lượng xử lý cần được điều tra thêm. Những ví dụ này cũng minh hoạ cách logic có thể di chuyển từ kết quả đến 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.

Số đường phố chưa được xác nhận không phải của Hoa Kỳ

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

Đã nhập địa chỉ Khu vực
Via Fonte Grugnale, 14 unit 2, 66054 VASTo CH, Ý 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
}

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ố đường phố chưa được xác nhận tại Hoa Kỳ

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

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

Dữ liệu USPS cho số nhà 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 USPS không đầy đủ cho một địa chỉ đã xác nhận

Ví dụ này minh hoạ mụ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à một validationGranularity là PREMISE. Tuy nhiên, uspsData không được điền đầy đủ và không chứa giá trị dpvConfirmation.

Đã nhập địa chỉ 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 có dữ liệu USPS không đầy đủ

{
  "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 có dữ liệu USPS không đầ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"
}