Отправьте отзыв о проверке адреса

Чтобы помочь нам улучшить качество API проверки адреса, вы можете при желании оставить отзыв в Google, чтобы сообщить нам, принят ли проверенный адрес конечным пользователем. Эта обратная связь помогает нам улучшить общую точность API.

Запрос обратной связи для проверки адреса

Чтобы предоставить обратную связь после вызова метода проверки адреса, выполните вызов метода ProvideValidationFeedback (REST) ​​или ProvideValidationFeedback (gRPC). В следующем примере выполняется запрос POST к REST API:

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 указывает, по каким результатам проверки адреса вы предоставляете отзыв. Это значение должно быть таким же, как значение responseId , возвращенное предыдущим вызовом метода validateAddress .

  Примеры вызова метода validateAddress см. в разделе Проверка адреса .

Как установить responseID

Каждый вызов API проверки адреса возвращает уникальное значение в поле responseId ответа.

В некоторых случаях вы можете выполнить несколько вызовов API проверки адреса для одного адреса. Например, конечный пользователь может внести изменения в свой адрес после просмотра результатов первой проверки. Затем вы выполняете вторую проверку обновленного адреса.

Если адрес, который вы пытаетесь проверить, необходимо повторно проверить, передайте responseId из первого ответа в поле previousResponseId во всех последующих запросах к API проверки адреса.

Каждый ответ на эти последующие запросы содержит новый responseId , но продолжайте использовать значение из первого responseId в previousResponseId до тех пор, пока проверка не будет завершена.

Дополнительные сведения о проверке обновленного адреса см. в разделе Проверка обновленного адреса .

В конце серии проверок мы рекомендуем вам вызвать API-интерфейс Provide Validation Feedback, чтобы сообщить нам окончательный результат всех проверок. Передайте responseId из первого ответа в запросе API предоставления обратной связи по проверке.

Эта диаграмма последовательности показывает желаемый поток: