提供地址验证反馈

为了帮助我们改进 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

此序列图显示了所需的流程:

使用回复 ID 可以验证地址。