Проверка адреса при оформлении покупки

Цель

В этом документе описываются методы объединения Place Autocomplete, Address Validation API¹ и Карт в процессе оформления заказа в электронной торговле с целью получения высококачественных адресов.

Требования

Google рекомендует ознакомиться со следующими материалами:

• Автозаполнение мест JavaScript документация для разработчиков.
  • Узнайте с технической точки зрения, как работает автозаполнение мест и какие есть варианты реализации.
• Руководство по реализации оформления заказа для автозаполнения мест.
  • Примеры рекомендаций по реализации Place Autocomplete на странице оформления заказа в интернет-магазине.
• Документация по продукту Address Validation API, в частности раздел Создание логики проверки.
  • Узнайте, как работает Address Validation API с технической точки зрения, и изучите сигналы, определяющие качество адреса.

Попробовать сейчас. Откройте консоль Google Cloud и включите Address Validation API.

Что такое проверка адреса?

Address Validation API – это сервис, который принимает адрес. Он определяет компоненты адреса и проверяет их. Он также преобразует адрес в стандартный почтовый формат и подбирает для него самые точные координаты широты и долготы. Для адресов в США и Пуэрто-Рико можно включить систему поддержки точности кодирования (CASS™).

Зачем нужна проверка адреса при оформлении покупки?

Собирайте точные адреса во время оформления заказа.
Это важный шаг для успешной доставки, увеличения своевременного выполнения заказов и снижения затрат на исправление адресов.

Помогите клиентам быстро и точно вводить адрес
Автозаполнение мест ускоряет ввод адреса и уменьшает количество ошибок, позволяя клиентам легко оформлять заказы. Address Validation API предоставляет информацию об общем качестве адреса, исправляет ошибки, например орфографические, и стандартизирует адрес, а также улучшает метаданные, например добавляет индикатор жилого или коммерческого здания (доступно в некоторых регионах).

Общие сведения о внедрении

В этом разделе описан рекомендуемый рабочий процесс ввода адреса при оформлении заказа в электронной торговле. Процесс состоит из трех этапов:

1. Используйте автозаполнение мест для первоначального ввода адреса.
2. Используйте Address Validation API, чтобы подтвердить введенный адрес.
3. Показывайте на карте местоположение введенного адреса, чтобы клиенты были уверены в правильности доставки.

Далее мы подробно рассмотрим каждый шаг.

Шаг 1. Процесс ввода адреса с помощью сервиса автозаполнения мест

Реализуйте автозаполнение мест с помощью JavaScript API в первой строке формы ввода адреса.

Автозаполнение мест предлагает пользователю варианты по мере ввода адреса. При использовании JavaScript API, когда пользователь начинает вводить адрес, под полем ввода появляется раскрывающийся список с результатами сервиса автозаполнения, который обновляется при каждом нажатии клавиши. Когда пользователь введет достаточно информации, чтобы найти адрес, он выбирает его из раскрывающегося списка. После этого поля формы будут автоматически заполнены данными адреса.

Автозаполнение мест позволяет предложить пользователю два варианта ввода: форму со всеми полями адреса или форму с одним полем ввода. Это единое поле ввода, которое предлагает пользователю начать поиск по мере ввода, а не вводить компоненты адреса по отдельности. После того как автозаполнение заполнит адрес, рабочий процесс расширяет поля формы данными адреса, позволяя клиенту просмотреть и внести изменения, например добавить номер квартиры или блока.

Вот пример того, как может выглядеть этот процесс с одним полем ввода:

Совет. Если вы используете новую версию автозаполнения, применяйте токены сеансов в вызовах API автозаполнения и Address Validation API, чтобы воспользоваться автозаполнением для оформления заказа и доставки по специальной цене.

Шаг 2. Используйте Address Validation API для проверки адресов

После того как пользователь введет адрес, мы рекомендуем вызвать Address Validation API на этапе оформления заказа, чтобы убедиться, что адрес действителен и указан полностью. Настройте вызов Address Validation API, когда пользователь нажимает кнопку "Далее" или "Продолжить" в форме адреса. Обычно эта кнопка ведет на страницу оплаты.

Google рекомендует вызывать Address Validation API для каждой транзакции.

На следующей блок-схеме показан пример сквозной интеграции Address Validation API в процесс оформления заказа.

Ниже в этом документе рассматриваются сценарии принятия адресов.

Шаг 3. Предоставьте визуальное подтверждение

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

Карту можно добавить на страницу оформления заказа, а также в письмо с подтверждением транзакции. В обоих случаях используются следующие API:

Maps JavaScript API предоставляет интерактивную карту для отображения местоположения пользователя.	Maps Static API позволяет встраивать изображения на веб-страницы или в электронные письма.

Примечание. Используйте объект geocode, возвращаемый Address Validation API, чтобы показать местоположение введенного адреса.

Подробный разбор: сценарии принятия адресов

Ответы Address Validation API можно разделить на три основные категории:

• Исправить – адрес низкого качества. Вам следует запросить дополнительную информацию.
• Подтвердить – адрес высокого качества, но отличается от введенного. Может появиться запрос на подтверждение.
• Принять – адрес высокого качества. Вы можете принять предложенный адрес.

Эта концепция рассматривается в разделе Создание логики проверки документации по Address Validation API. В этом разделе мы обсудим каждый сценарий.

Совет. Логика также доступна в виде веб-компонента с открытым исходным кодом в расширенной библиотеке компонентов.

Исправить

В этом разделе рассказывается, как устранить проблему с вводом адреса. Информацию о сигналах, которые Address Validation API возвращает, чтобы указать на низкое качество адреса, можно найти в разделе Исправление адреса документации по созданию логики проверки.

Если Address Validation API возвращает ответ о том, что адрес недействителен, перенаправьте клиента на форму ввода адреса, чтобы он проверил введенные данные. После исправления адреса ваш сервис должен повторно отправить его в Address Validation API, чтобы убедиться, что внесенные исправления действительны.

Вы также можете выделить определенные ошибки в строке адреса, используя сигналы, возвращаемые на уровне addressComponents. Пример показан на скриншоте справа.

---

Подтвердить

В этом разделе рассказывается, как подтвердить адрес. Информацию о конкретных сигналах, которые возвращает Address Validation API, чтобы указать, что адрес должен быть подтвержден, см. в разделе Подтверждение адреса в документации по созданию логики проверки.

Часто система предлагает пользователю подтвердить адрес. Например, клиент может неправильно написать название города, и Address Validation API исправит ошибку. Подтвердите это исправление у клиента. Это связано с тем, что изменения, внесенные с помощью API, могут существенно отличаться от исходных данных.

Используйте межстраничное модальное окно, чтобы показать информацию клиенту. В нем должно быть три варианта действий:

1. Подтвердите адрес, полученный от API, и продолжите оформление заказа, используя исправленный адрес.
2. Выберите адрес в том виде, в котором он был введен изначально, игнорируя исправление от Address Validation API. Процесс оформления заказа может продолжаться в обычном режиме, а заказ можно пометить для дальнейшей проверки перед отправкой, если это предусмотрено вашим процессом.
3. Клиент отменяет или закрывает модальное окно, возвращаясь к этапу ввода адреса в процессе оформления заказа, где он может ввести адрес с нуля, начиная процесс заново.

Пример показан на скриншоте справа.

---

Принять

В этом разделе рассказывается, как принять адрес. Информацию о том, какие сигналы возвращает Address Validation API, чтобы указать, что адрес качественный и его следует принять, можно найти в разделе Принятие адреса документации по созданию логики проверки.

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

Мы рекомендуем использовать данные адреса, возвращенные Address Validation API, для заказа, поскольку они могут содержать незначительные исправления и дополнения, например:

• Использование заглавных букв
• Исправления форматирования, например:
  • Street – St
  • Правильный порядок компонентов адреса
• ZIP+4 в США.

Совет. Обязательно показывайте адрес на странице оплаты, даже если он не привлекает внимания.

---

О чем важно помнить

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

Google рекомендует предоставить клиентам до двух попыток ввести адрес. При второй попытке принимайте введенные данные, даже если они не проходят проверку. При второй попытке пользователь должен иметь возможность продолжить независимо от результатов проверки.

Вот два способа принять вторую попытку:

• Принудительное продолжение. Показать клиенту модальное окно с сообщением о том, что адрес не проходит проверку, но разрешить продолжить с введенным адресом.
• Автоматическое принятие. Автоматически принимать вторую попытку без подтверждения, даже если адрес не полностью подтвержден.

По возможности настройте систему так, чтобы она помечала адреса, которые не прошли проверку. Тогда специалист службы поддержки сможет проверить их до отправки заказа. Это дополнительная мера, которая поможет вам избежать ошибок.

Рассмотрим пример, который показывает, почему рекомендуется выполнять эту проверку. Между завершением строительства здания и появлением его адреса в базах данных почтовых адресов может пройти некоторое время. У покупателей должна быть возможность принудительно перейти на страницу оформления покупки с введенным адресом, даже если он не прошел проверку.

После завершения сеанса оформления заказа вы можете использовать метод provideValidationFeedback, чтобы отправить в Google отзыв о попытке проверки адреса.

Заключение

В этом документе приведены общие сведения о процессе оформления заказа с использованием автозаполнения, Address Validation и визуального подтверждения на карте Google. Используйте этот документ в качестве отправной точки для разработки реализации, следуя рекомендованным процессам ввода адреса.

Дальнейшие действия

Дополнительные сведения

• Документация по автозаполнению мест
• Документация по Address Validation API
• Отчеты по платформе Google Карт

Авторы

Хенрик Вальве | разработчик решений
Тома Англаре | разработчик решений
Сартхак Гангули | разработчик решений

---

1. Неисключительный лицензиат Почтовой службы США. Следующие товарные знаки принадлежат Почтовой службе США(United States Postal Service®) и используются с ее разрешения: CASS™, USPS®, DPV®. ↩