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ế 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 chấp nhận từ hệ thống của bạn. Hãy xem phần Tổng quan về quy trình làm việc trong Sử dụng phản hồi 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ỉ được chấp nhận

Ví dụ bên dưới làm nổi bật các tín hiệu quan trọng.

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

Ngoài ra, verdict cho biết những điều sau:

  • hasUnconfirmedComponents vẫn là false
  • hasInferredComponents vẫn là false
  • hasReplacedComponents vẫn là false

Khi kết hợp với nhau, các tín hiệu này cho biết một địa chỉ có 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 trường hợp mà verdict cho biết các vấn đề về chất lượng địa chỉ cần được điều tra thêm. Các 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 chưa được xác nhậ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 các thành phần không đượ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 một số đường chưa được xác nhận

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

Việc điều tra thêm các thành phần địa chỉ cho thấy rằng mức độ xác nhận cho số đường là UNCONFIRMED_BUT_PLAUSIBLE.

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

Số đường 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ỉ, cùng với các thành phần không được suy luận hoặc thay thế. Tuy nhiên, validationGranularity là PREMISE_PROXIMITY.

Địa chỉ đã nhập Vùng
975 Carson Dr, Sunnyvale, CA 94086 Hoa Kỳ

Dữ liệu USPS cho một 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 USPS không đầy đủ 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ỳ có tất cả các thành phần địa chỉ đã xác nhận, cùng với các thành phần không được suy luận hoặc thay thế và validationGranularity là PREMISE. Tuy nhiên, uspsData không được điền đầy đủ và không chứa giá trị dpvConfirmation.

Địa chỉ đã nhập Vùng
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 USPS cho một địa chỉ đã xác nhận 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"
}