Tài liệu này mô tả một số tình huống thực tế khi API xác thực địa chỉ cung cấp các tín hiệu phản hồi đảm bảo cho hành vi chấp nhận từ hệ thống của bạn. Xem Tổng quan về quy trình công việc trong Sử dụng phản hồi xác thực để xác định 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ònfalse
hasInferredComponents
vẫn cònfalse
hasReplacedComponents
vẫn cònfalse
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
cho biết địa chỉ
vấn đề về chất lượng cần được điều tra thêm. Các 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 bức tranh toàn diện hơn nhằm nâng cao logic hệ thống của bạn.
Số đường phố chưa được xác nhận không phải của Hoa Kỳ
Ví dụ này minh hoạ việc nhập một địa chỉ ở Ý với tất cả các thành phần địa chỉ
xuất hiện, 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 trên đường
số điện thoại 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ạ việc nhập một địa chỉ ở Hoa Kỳ với tất cả các thành phần địa chỉ
mà 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ạ việc nhập một địa chỉ ở Hoa Kỳ với tất cả các thành phần địa chỉ
không có thành phần nào được dự đoán hoặc thay thế và
validationGranularity
trong tổng số PREMISE
. Tuy nhiên, uspsData
chưa đầy đủ
được điền sẵn 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"
}