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

Цель

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

Предварительные условия

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

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

Попробуйте сейчас: посетите консоль Google Cloud и включите API проверки адреса .

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

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

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

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

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

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

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

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

Далее мы углубимся в каждый шаг в отдельности.

Шаг 1. Порядок ввода адреса – использование службы автозаполнения мест.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Исправить

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

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

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

---

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

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

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

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

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

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

---

Принимать

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

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

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

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

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

---

Рекомендации по реализации

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

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

Два предлагаемых метода принятия второй попытки:

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

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

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

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

Заключение

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

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

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

Рекомендуемое дальнейшее чтение:

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

Авторы

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

---

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