为了帮助我们提高 Address Validation API 的质量,您可以选择向 Google 提供反馈,让我们知道最终用户是否接受经过验证的地址。该反馈有助于我们提高 API 的整体准确性。
地址验证反馈请求
如需在调用地址验证方法后提供反馈,请调用 ProvideValidationFeedback 方法 (REST) 或 ProvideValidationFeedback 方法 (gRPC)。以下示例向 REST API 发出 POST 请求:
https://addressvalidation.googleapis.com/v1:provideValidationFeedback?key=YOUR_API_KEY
将 JSON 正文传递给 POST 请求,定义地址验证的总结:
{
"conclusion": "VALIDATED_VERSION_USED",
"responseId": "de22bed8-7f52-44cb-8526-faceac57150a"
}
其中:
conclusion
字段应反映验证的实际结果。在此示例中,您将
VALIDATED_VERSION_USED
作为conclusion
字段的值传递,以表明您最终使用的地址是 API 返回的地址。如果您最终使用最终用户提供的地址,请传递
USER_VERSION_USED
。如需了解
conclusion
的所有可能的值,请参阅 ValidationConclusion。responseId
字段指定您要针对哪些地址验证结果提供反馈。此值必须与之前调用 validateAddress 方法返回的responseId
值相同。如需查看调用
validateAddress
方法的示例,请参阅验证地址。
如何设置responseID
每个 Address Validation API 调用都会在响应的 responseId
字段中返回一个唯一值。
在某些情况下,您可能会对单个地址多次调用 Address Validation API。例如,最终用户可能会在看到首次验证的结果后更改其地址。然后,您对更新后的地址执行第二次验证。
如果要验证的地址需要重新验证,请将所有后续请求 previousResponseId
字段中的第一个响应的 responseId
传递给 Address Validation API。
这些后续请求的每个响应都包含新的 responseId
,但请在previousResponseId
期间使用第一个 responseId
的值,直到验证完成为止。
如需详细了解如何验证更新后的地址,请参阅验证更新后的地址。
在一系列验证结束时,我们建议您调用提供 Validation Feedback API,告诉我们所有验证的最终结果。在“提供验证反馈”API 请求中的第一个响应中传递 responseId
。
以下序列图显示了所需的流程: