為協助我們改善 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,讓我們瞭解所有驗證的最終結果。從提供 Validation Feedback API 要求中的第一個回應傳遞 responseId
。
這張序列圖顯示所需的流程: