Để giúp chúng tôi cải thiện chất lượng của API xác thực địa chỉ, bạn có thể tuỳ ý cung cấp ý kiến phản hồi cho Google để cho chúng tôi biết liệu địa chỉ đã xác thực có được người dùng cuối chấp nhận hay không. Phản hồi này giúp chúng tôi cải thiện độ chính xác tổng thể của API.
Yêu cầu phản hồi xác thực địa chỉ
Để cung cấp ý kiến phản hồi sau khi gọi phương thức xác thực địa chỉ, hãy gọi phương thức provideValidationFeedback (REST) hoặc ProvideValidationFeedback (gRPC). Ví dụ sau đây tạo yêu cầu POST tới API REST:
https://addressvalidation.googleapis.com/v1:provideValidationFeedback?key=YOUR_API_KEY
Chuyển phần nội dung JSON vào yêu cầu POST xác định kết thúc xác thực địa chỉ:
{
"conclusion": "VALIDATED_VERSION_USED",
"responseId": "de22bed8-7f52-44cb-8526-faceac57150a"
}
Trong trường hợp:
Trường
conclusion
phải phản ánh kết quả xác thực thực tế.Trong ví dụ này, bạn chuyển
VALIDATED_VERSION_USED
làm giá trị của trườngconclusion
để cho biết địa chỉ cuối cùng bạn sử dụng là địa chỉ do API trả về.Cuối cùng, nếu bạn sử dụng địa chỉ do người dùng cuối cung cấp, hãy chuyển
USER_VERSION_USED
.Để biết tất cả các giá trị có thể có cho
conclusion
, hãy xem ValidationConclusion.Trường
responseId
chỉ định kết quả xác thực địa chỉ mà bạn đang cung cấp ý kiến phản hồi. Giá trị này phải giống với giá trịresponseId
do lệnh gọi trước đến phương thức validateAddress trả về.Để biết ví dụ về cách gọi phương thức
validateAddress
, hãy xem phần Xác thực địa chỉ.
Cách đặt responseID
Mỗi lệnh gọi API Xác thực địa chỉ sẽ trả về một giá trị duy nhất trong trường responseId
của phản hồi.
Trong một số trường hợp, bạn có thể thực hiện nhiều lệnh gọi tới API xác thực địa chỉ cho một địa chỉ. Ví dụ: người dùng cuối có thể thay đổi địa chỉ sau khi xem kết quả của lần xác thực đầu tiên. Sau đó, bạn thực hiện xác thực lần thứ hai trên địa chỉ đã cập nhật.
Nếu một địa chỉ bạn đang cố gắng xác thực cần được xác thực lại, hãy chuyển responseId
từ phản hồi đầu tiên trong trường previousResponseId
trong tất cả các yêu cầu theo dõi đến API xác thực địa chỉ.
Mỗi phản hồi cho các yêu cầu theo dõi này chứa một responseId
mới, nhưng vẫn tiếp tục sử dụng giá trị từ responseId
đầu tiên trong previousResponseId
cho đến khi xác thực xong.
Để biết thêm thông tin về việc xác thực địa chỉ đã cập nhật, hãy xem phần Xác thực địa chỉ đã cập nhật.
Khi kết thúc một chuỗi xác thực, bạn nên gọi đến API cung cấp phản hồi xác thực để cho chúng tôi biết kết quả cuối cùng của tất cả các xác thực. Truyền responseId
từ phản hồi đầu tiên trong yêu cầu API cung cấp phản hồi xác thực.
Sơ đồ trình tự này cho thấy quy trình mong muốn: