Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
W niektórych przypadkach możesz wykonać wiele wywołań interfejsu Address Validation API dla jednego adresu. Na przykład klient może wprowadzić zmiany w adresie po wyświetleniu wyników pierwszej weryfikacji. Następnie przeprowadź drugą weryfikację zaktualizowanego adresu.
W tym dokumencie opisujemy 2 kluczowe działania, które możesz wykonać, gdy wysyłasz serię żądań dotyczących tego samego adresu do interfejsu Address Validation API. Te działania nie są ścisłym wymaganiem dotyczącym użytkowania, ale mogą pomóc w poprawie ogólnej jakości danych i reakcji systemu.
Wyślij żądanie do punktu końcowego provideValidationFeedback.
Ustawianie pola previousResponseID
Wysyłanie prośby provideValidationFeedback
Po zakończeniu serii weryfikacji Google zaleca wywołanie interfejsu Provide Validation Feedback API, aby wskazać ostateczny wynik wszystkich weryfikacji. Żądanie ustawia 2 pola:
conclusion – wskazuje wersję weryfikacji używaną w usłudze, niezależnie od tego, czy była to wersja podana przez użytkownika, czy zwrócona przez interfejs Address Validation API.
responseId – identyfikator odpowiedzi pierwszej odpowiedzi z interfejsu Address Validation API. Zobacz sekcję Ustawianie pola previousResponseId poniżej.
Pole conclusion określa jedną z tych czynności po Twojej stronie:
VALIDATED_VERSION_USED: zweryfikowana wersja adresu z interfejsu Address Validation API.
USER_VERSION_USED: oryginalna wersja przesłana przez użytkownika.
UNVALIDATED_VERSION_USED: wersja, która powstała w wyniku promptu do użytkownika, ale nie została ponownie zweryfikowana za pomocą interfejsu Address Validation API.
Pole responseId określa, w przypadku których wyników weryfikacji adresu przesyłasz opinię. Ta wartość musi być taka sama jak wartość responseId zwrócona przez pierwsze wywołanie metody validateAddress.
Więcej informacji znajdziesz w sekcji Treść żądania w przewodniku po opiniach o sprawdzaniu poprawności.
Ustawianie pola previousResponseID
Wysyłając do interfejsu Address Validation API kolejne żądanie dotyczące danego adresu, ustaw pole previousResponseId.
W przypadku wartości previousResponseId użyj wartości z responseId
zwróconej przez interfejs API po pierwszym żądaniu weryfikacji.
Używaj tej samej wartości w przypadku wszystkich kolejnych żądań, dopóki seria się nie zakończy.
Ten diagram sekwencji pokazuje preferowany przepływ:
[null,null,["Ostatnia aktualizacja: 2025-08-31 UTC."],[[["\u003cp\u003eWhen validating an address multiple times, use the \u003ccode\u003eprovideValidationFeedback\u003c/code\u003e endpoint to inform Google of the final address version used.\u003c/p\u003e\n"],["\u003cp\u003eInclude the original response ID in the \u003ccode\u003eprovideValidationFeedback\u003c/code\u003e request and set the \u003ccode\u003epreviousResponseId\u003c/code\u003e for subsequent validation calls to improve data quality and response time.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003econclusion\u003c/code\u003e field in the feedback request indicates whether the user's original, a validated, or another address version was ultimately used.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003epreviousResponseId\u003c/code\u003e helps the API understand the context of the address validation sequence and potentially optimize results.\u003c/p\u003e\n"]]],[],null,["In some cases, you might make multiple calls to the\nAddress Validation API for a single address. For example, the customer might make\nchanges to their address after seeing the results of the first\nvalidation. You then perform a second validation on the updated address.\n\nThis document describes two key actions you can take when you issue a series of\nrequests for the same address to the Address Validation API. These actions are\nnot a strict usage requirement, but a helpful action on your part to improve\noverall data quality and system response.\n\n- Send a request to the `provideValidationFeedback` endpoint\n- Set the `previousResponseID` field\n\nSend a `provideValidationFeedback` request\n\nAt the end of a series of validations, Google recommends making a call to the\nProvide Validation Feedback API to indicate the final outcome of\nall the validations. The request sets two fields:\n\n- `conclusion` --- Indicates the validation version you used in your service, whether it was the one provided by the user, or the one returned from the Address Validation API.\n- `responseId` --- Indicates the response ID of the **first** response from the Address Validation API. See [Set the previousResponseId field](#followup-requests) below.\n\nUse either the\n[provideValidationFeedback](/maps/documentation/address-validation/reference/rest/v1/TopLevel/provideValidationFeedback)\nmethod (REST) or\n[ProvideValidationFeedback](/maps/documentation/address-validationreference/rpc/google.maps.addressvalidation.v1#google.maps.addressvalidation.v1.AddressValidation.ProvideValidationFeedback)\nmethod (gRPC).\n\nThe following example passes a [JSON body](/maps/documentation/address-validation/reference/rest/v1/TopLevel/validateAddress#request-body) to the request defining the\nconclusion: \n\n```json\ncurl -X POST -d '{\n \"conclusion\": \"VALIDATED_VERSION_USED\",\n \"responseId\": \"de22bed8-7f52-44cb-8526-faceac57150a\"\n}' \\\n-H 'Content-Type: application/json' \\\n\"https://addressvalidation.googleapis.com/v1:provideValidationFeedback?key=\u003cvar translate=\"no\"\u003eAPI_KEY\u003c/var\u003e\"\n```\n\n- The `conclusion` field identifies one of the following actions from your side:\n - `VALIDATED_VERSION_USED`: the validated version of the address from the Address Validation API.\n - `USER_VERSION_USED`: the original version provided by the user.\n - `UNVALIDATED_VERSION_USED`: a version that was a result of a prompt to the user, but did not re-validate it with the Address Validation API.\n - `UNUSED`: abandoned the transaction.\n\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| See [Validation Conclusion](/maps/documentation/address-validation/reference/rest/v1/TopLevel/provideValidationFeedback#validationconclusion) in the reference guide. |\n\n- The `responseId` field specifies which address validation results you are providing feedback for. This value must be the same as the `responseId` value returned by the **first** call to the [validateAddress](/maps/documentation/address-validation/reference/rest/v1/TopLevel/validateAddress) method.\n\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| See [Request Body](/maps/documentation/address-validation/reference/rest/v1/TopLevel/provideValidationFeedback#request-body) in the validation feedback reference guide. |\n\nSet the `previousResponseID` field\n\nWhen issuing a follow-up request the Address Validation API for a given address, set\nthe `previousResponseId` field.\n\n- For the value of the `previousResponseId`, use the value from the `responseId` returned by API after the **first** validation request.\n- Use this same value for any and all followup requests until the series completes.\n\nThis sequence diagram shows the preferred flow:"]]
