为了帮助我们改进 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
的值,直到验证完成。
如需详细了解如何验证更新后的地址,请参阅验证更新后的地址。
在一系列验证结束时,我们建议您调用 Provide Validation Feedback API,告知我们所有验证的最终结果。从“提供验证反馈”API 请求中的第一个响应中传递 responseId
。
此序列图显示了所需的流程: