Что это делает?

Функция автозаполнения адресов для Gravity Forms помогает пользователям быстрее вводить точные адреса, показывая подсказки от Google по мере ввода. Работает с обеими платформами. Адрес и Текст в одну строку поля.

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

Особенности

Более быстрое заполнение адресов
Пользователи получают подсказки от Google по мере ввода текста, что сокращает количество нажатий клавиш и ускоряет отправку ответов.
Работает с полями «Адрес» + «Текст в одну строку».
Включите автозаполнение для любого типа полей, чтобы сохранить существующие макеты форм.
Разобранное сопоставление полей
Введите адрес (строка 1, строка 2), город/населенный пункт, штат/регион, почтовый индекс и страну в любое выбранное поле той же формы, включая скрытые поля.
Обработка адресов, удобная для международных запросов
Поддерживает глобальные адреса и использует нейтральные по отношению к стране метки в настройках для команд за пределами США.
Ограничить результаты по стране
Ограничьте количество предлагаемых вариантов, используя коды ISO (например, США, Канада, Великобритания).
Метаданные сохраняются с каждой записью.
В хранилище находятся идентификатор пользователя, координаты широты, долготы и отформатированный адрес для интеграции, автоматизации и устранения неполадок.
Совместимость с WordPress Multisite
Активируйте сетевую функцию один раз, чтобы использовать ее на всех ваших дочерних сайтах. (Сетевой режим доступен в тарифных планах с безлимитным трафиком.)
Перевод готов
Полностью совместимо с выбранным вами плагином перевода.Предварительные переводы не включены, но появятся в ближайшее время.)
Поиск почтового индекса
Превратите одно поле в поле поиска по почтовому индексу, которое автоматически заполняет поля “Город” и «Штат/Регион» (включая скрытые) — идеально подходит для форм «отметьте свой район» и маршрутизации в CRM-системах.

Перейти к описанию функций

Как включить плагин?

После приобретения функции автозаполнения адресов для Gravity Forms вам потребуется:

Установите плагин на свой сайт WordPress.
Сгенерируйте и введите свой ключ API Google.
Включить автозаполнение адреса или Текстовое поле, содержащее одну строку.

Приведенные ниже инструкции покажут вам, как установить плагин, сгенерировать ключ Google API для автозаполнения адресов и включить его для поля "Адрес" или текстового поля "Одна строка".

Зарегистрируйте плагин в Plugin Brewery

Сгенерируйте и введите ключ API Google.

Прежде чем использовать функцию автозаполнения адресов, необходимо сгенерировать ключ API в консоли Google Cloud Platform.

Включить для полей адреса

Включить для полей с текстом в одну строку

Генерация ключа API Google

Создайте или выберите существующий проект Google Cloud.

Прежде чем получить ключ API Google, вам необходимо... создать новый Проект Google Cloud Platform (или выберите существующий, если он у вас есть).

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

Включить необходимые API

После создания или выбора проекта Google Cloud перейдите в раздел API и сервисы > Библиотека API и включите следующие API:

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

API для работы с местами (новый)

Быстрая ссылка

Вы можете заметить надписи “Places API” и “Places API (New)” — наш плагин разработан для совместимости с “Places API (New)”.”

API карт на JavaScript

Быстрая ссылка

Сгенерировать ключ

Теперь, когда оба API включены в вашем проекте, вы можете сгенерировать свой API-ключ.

Перейти к API и сервисы > Учетные данные, Затем нажмите “+ Создать учетные данные” и, наконец, “Ключ API”.”

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

На этом этапе вы можете прокрутить страницу вниз и нажать “Создать”, и ваш ключ будет сгенерирован немедленно. ОДНАКО… на следующем шаге вам следует установить ограничение, чтобы предотвратить несанкционированное использование вашего ключа.

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

Прокрутите вниз до пункта “Ограничения приложения” в диалоговом окне.

В разделе “Ограничения приложения” выберите “Веб-сайты”.”

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

Для обеспечения корректной работы ключа как для доменов с www, так и без www, мы рекомендуем добавить домен с подстановочным знаком: *.example-website.com/*

Нажмите «Создать», и ваш ключ появится рядом.

Теперь ваш API-ключ создан! Скопируйте его и вставьте в настройки автозаполнения адреса плагина, и всё готово!

Форматирование домена: Каждый домен следует указывать на отдельной строке, используя следующий формат: example.com/* - нет https://, без завершающей косой черты в самом домене, но включает в себя /* В конце разрешить доступ ко всем страницам. Для охвата всех поддоменов (например, www), добавить отдельную запись как *.example.com/*. Для локального развития используйте localhost или localhost:3000/* в зависимости от вашей конфигурации.

yourdomain.com/*
*.yourdomain.com/*
staging.yourdomain.com/*
localhost:8080/*

Условия использования и политика конфиденциальности Google

Функция автозаполнения адресов Plugin Brewery отправляет данные формы в сервисы Google для выполнения поиска адресов. В соответствии с рекомендациями Google, любое приложение, использующее Places API, должно отображать ссылку на Google. Условия предоставления услуг и Политика конфиденциальности.

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

Подробная информация о функциях

Поддерживаемые типы полей

Работает с обоими типами полей Gravity Forms:

Поле адреса (многоканальный ввод)
Однострочный текст (ввод адреса в одну строку)

Используйте поля «Адрес», если вам нужны стандартные подполя адреса GF, или «Однострочный текст», если вам нужен более простой макет формы.

Разобранное сопоставление адресов (новое)

Сопоставьте выбранные компоненты адреса с отдельными полями в вашей форме:

Адресная строка 1
Адресная строка 2
Почтовый / ZIP
Город / Поселок
Государство / Провинция / Регион
Страна

Отлично подходит для скрытых полей, используемых при проверке зон доставки, маршрутизации в CRM, условных уведомлений и автоматизации.

Поиск почтового индекса (новая функция)

Превратите текстовое поле в однострочный поиск в поле для ввода почтового индекса. Включите автозаполнение адреса, а затем активируйте поиск по почтовому индексу в расширенных настройках поля.

Предложения ограничиваются почтовыми индексами.
В поле сохраняется только выбранный код (а не полный адрес).
Город, штат/регион (и страна/округ, если они указаны на карте) заполняются автоматически, в том числе и в скрытые поля.
Работает для любой страны, в которой есть почтовые индексы.

Идеально подходит для проверки зоны обслуживания, анализа логики доставки и отправки корректных данных о местоположении в вашу CRM-систему.

Однострочный текст. Обработка почтовых/почтовых отправлений.

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

Метаданные сохранены в метаданных записи.

Когда пользователи выбирают подсказку, плагин сохраняет следующие данные:

Идентификатор места
Широта
Долгота
Отформатированный адрес

Ограничения по странам + международная поддержка

Вы можете ограничить список предлагаемых стран определенными странами, используя коды ISO alpha-2 (например: US,CA,GB), или оставить без ограничений для глобальных форм.

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

Производительность + Совместимость

Разработано для реальных производственных площадок:

Фронтенд-скрипты инициализируются только там, где существуют включенные поля.
Работает со стандартными и AJAX-процессами Gravity Forms.
Совместимо с распространенными системами кэширования/CDN в большинстве конфигураций.

Теги слияния

Когда посетитель выбирает вариант автозаполнения, плагин может сохранять метаданные для этой записи. Вы можете вставлять эти данные в подтверждения, уведомления и другие места, поддерживающие теги слияния Gravity Forms.

Формат: {pb_aac:ID:KEY}

Замените ID на идентификатор поля «Адрес» или «Текст в одну строку», в котором включено автозаполнение адреса (то же поле, где отображаются подсказки).

Доступные ключи (KEY):

КЛЮЧ	Что оно выдает
`place_id`	Идентификатор места Google
`lat`	Широта
`lng`	Долгота
`formatted`	Отформатированный адрес (отформатированная строка Google)
`google_maps_url`	Поисковый URL-адрес Google Maps, сформированный на основе идентификатора места (или координат широты/долготы, если идентификатор места отсутствует).

Примеры (если поле автозаполнения — поле 12):

{pb_aac:12:place_id}
{pb_aac:12:lat}
{pb_aac:12:lng}
{pb_aac:12:formatted}
{pb_aac:12:google_maps_url}

Выбор тегов: В редакторе форм эти теги также отображаются в инструменте выбора тегов слияния под метками типа “Автозаполнение адреса: …”.

Примечание: Значения существуют только для записей, для которых было выбрано подсказка и сохранены метаданные; в противном случае тег считается пустым (так задумано).

Часто задаваемые вопросы

API Google Places бесплатен?

Google автоматически зачисляет на ваш счет ежемесячный кредит в размере $200, из которого оплачивается использование Places API. Для большинства сайтов этого достаточно, чтобы покрыть все расходы — по текущим тарифам, в этот кредит попадает примерно 10 000 сессий автозаполнения в месяц.

Тем не менее, цены могут меняться, поэтому проверяйте информацию. Таблица цен платформы Google Maps для получения последних данных.

Можно ли использовать это с полем “Однострочный текст”?

Да! В дополнение к стандартному полю «Адрес» вы можете включить автозаполнение для любого поля «Однострочный текст». Идеально подходит для форм, в которых требуется ввести только один адрес.

Работает ли это для международных адресов?

Безусловно. Плагин поддерживает глобальные адресные данные от Google.

Сложна ли настройка?

Вовсе нет. Просто добавьте свой ключ Google API в настройках плагина, включите автозаполнение для выбранных полей, и все готово. Это так просто.

Могу ли я ограничить результаты поиска определенными странами?

Да. В настройках поля укажите список кодов стран ISO 3166-1 alpha-2, разделенных запятыми (например, US,CA,GB).

Какой API Places мне нужно включить в Google Cloud?

Включите “API мест (новый)”, поскольку устаревший “API мест” планируется прекратить поддержку, как и “API карт на JavaScript”.

Можно ли использовать метаданные адреса в уведомлениях или интеграциях?

Да. Функция автозаполнения адресов добавляет теги слияния для идентификатора места, широты, долготы, отформатированного адреса и URL-адреса Google Maps. Используйте инструмент выбора тегов слияния Gravity Forms в любых уведомлениях, подтверждениях или сопоставлениях ленты.

Могут ли разработчики настраивать результаты поиска Google?

Да. Используйте pb_aac_request Фильтр JavaScript для корректировки запроса — например, для смещения результатов в сторону определенного региона, добавления ограничивающей рамки или расширения результатов для включения предприятий.

Можно ли использовать поле для поиска почтового индекса?

Да. В текстовом поле, отображающем одну строку, включите автозаполнение адреса, а затем — поиск почтового индекса. Поле отобразит подсказки по почтовому индексу, и выбор одной из них заполнит выбранные вами поля “Город” и «Штат/Регион» (включая скрытые). Отлично подходит для форм типа «проверьте свой район» и маршрутизации в CRM.

	Добавьте в форму поле «Адрес».
	Откройте настройки поля, перейдите в раздел Передовой раздел и включить Автозаполнение адреса флажок.

	Добавьте в форму поле для ввода текста в одну строку.
	Откройте настройки поля, перейдите в раздел Передовой раздел и включить Автозаполнение адреса флажок.