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 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 công việc trong bài viết Sử dụng phản hồi xác thực để biết bối cảnh.
Ví dụ phổ biến: chấp nhận
Tình huống 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 địa chỉ được 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 cho biết những thông tin sau:
hasUnconfirmedComponents
vẫn cònfalse
hasInferredComponents
vẫn làfalse
hasReplacedComponents
vẫn làfalse
Khi kết hợp với nhau, những 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 verdict
cho biết 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ể 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 nâng cao logic hệ thống.
Số nhà chưa xác nhận ở bên ngoài 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
.
Đị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
}
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 đị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 về 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 chưa đầy đủ cho một địa chỉ đã xác nhận
Ví dụ này minh hoạ việc nhập đị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
không đượ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 có dữ liệu USPS chưa đầy đủ
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true,
}
Dữ liệu của USPS cho một địa chỉ đã được 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"
}