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. Xem phần Tổng quan về quy trình công việc trong phần Sử dụng phản hồi xác thực để biết thêm thông tin.
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.
Đã nhập địa chỉ | Khu vực |
---|---|
76 Buckingham Palace Road, London SW1W 9TQ | Vương quốc Anh |
Kết quả về đị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, câu trả lời còn cho biết những thông tin sau:
hasUnconfirmedComponents
vẫn làfalse
hasInferredComponents
vẫn làfalse
hasReplacedComponents
vẫn làfalse
Khi được kết hợp với nhau, những 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 minh hoạ những trường hợp trong đó verdict
cho biết giải quyết cá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ể đi 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ố nhà chưa được xác nhận ở Hoa Kỳ
Ví dụ này minh hoạ mục nhập địa chỉ tại Ý 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 thay thế hoặc suy luận. Tuy nhiên, validationGranularity
là ROUTE
.
Đã nhập địa chỉ | Khu vực |
---|---|
Thông qua Fonte Grugnale, 14 đơn vị 2, 66054 VASTo CH, Italia | IT |
Kết quả về 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 các thành phần địa chỉ, chúng ta sẽ thấy số nhà là UNCONFIRMED_BUT_PLAUSIBLE
.
{
"text": "14",
"componentType": "street_number",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}
Số đường phố chưa được Hoa Kỳ xác nhận
Ví dụ này minh hoạ mụ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 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ố đường phố 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 địa chỉ đã được 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 suy luận hoặc thay thế) và validationGranularity
của 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 đị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 địa chỉ đã được xác nhận nhưng dữ liệu 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"
}