Проверка адреса для электронной торговли

Цель

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

Предпосылки

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

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

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

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

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

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

Помогите клиентам быстро и точно ввести адрес:
Функция автозаполнения Place Autocomplete ускоряет ввод адреса и сокращает количество ошибок, позволяя клиентам легко проходить этапы оформления заказа. Функция проверки адреса предоставляет обратную связь по общему качеству адреса, вносит исправления, такие как стандартизация и орфографические ошибки, а также дополняет метаданные, например, указывая, что адрес жилой или коммерческий (доступно в некоторых регионах ).

Обзор реализации

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

1. Используйте функцию автозаполнения места для первоначального ввода адреса.
2. Используйте API проверки адреса для подтверждения введенного адреса.
3. Отображение местоположения введенного адреса на карте для обеспечения уверенности клиентов в доставке.

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

Шаг 1: Ввод адреса с использованием сервиса автозаполнения Place

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

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

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

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

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

После того, как пользователь введёт адрес, Google рекомендует вызвать API проверки адреса при оформлении заказа, чтобы убедиться в его корректности и полноте. Вызов API проверки адреса должен выполняться при нажатии пользователем кнопки «Далее» или «Продолжить» в форме ввода адреса. Эта кнопка часто открывает страницу оплаты.

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

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

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

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

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

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

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

Глубокое погружение — рассмотрение сценариев принятия

Ответы API проверки адресов можно разделить на три основных сценария:

• handyman на все руки: адрес некачественный. Вам следует запросить дополнительную информацию.
• edit — адрес высокого качества, но отличается от введенного. Возможно, вам потребуется подтверждение.
• check «Принять » — адрес высокого качества. Вы можете принять предоставленный адрес.

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

Исправить

В этом разделе показано, как исправить адрес. Информация о конкретных сигналах, которые API проверки адресов возвращает для указания на низкое качество адреса, приведена в разделе «Исправление адреса» в документации «Создание логики проверки».

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

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

---

Подтверждать

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

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

Используйте промежуточное модальное окно для отображения информации клиенту, предлагая три варианта дальнейших действий:

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

Пример этого можно увидеть на снимке экрана справа.

---

Принимать

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

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

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

• Капитализация
• Исправления форматирования, например
  • От улицы до ул.
  • Правильный порядок компонентов адреса
• Почтовый индекс+4 в США.

---

Соображения по реализации

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

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

Предлагаются два способа принять вторую попытку:

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

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

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

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

Заключение

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

Следующие шаги

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

Рекомендуемая дополнительная литература:

• Место автозаполнения документации
• Документация API проверки адресов
• Отчеты платформы Google Maps

Авторы

Хенрик Валв | Инженер по решениям
Томас Англерет | Инженер по решениям
Сартак Гангули | Инженер по решениям