Настройка модуля «2GIS Карты»

Карты 2GIS с детальной информацией о зданиях и организациях Эта инструкция написана для владельца ADWOS CMS: что подготовить, где включить модуль, какие поля проверить и как понять, что запуск прошел корректно.

Когда стоит подключать модуль

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

Что изменится на сайте

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

Что подготовить заранее

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

• Получите API-ключ у провайдера «2GIS Карты».
• Ограничьте ключ доменом сайта и включите только нужные API: карты, геокодирование, подсказки или поиск.
• Подготовьте адрес, который точно должен находиться на карте.
• Проверьте страницу или форму, где карта должна появиться после включения.

Установка в ADWOS CMS

• Откройте административную панель ADWOS CMS под учетной записью администратора.
• В меню выберите раздел «Каталог», затем откройте «Маркетплейс».
• Найдите модуль «2GIS Карты» по названию или через список модулей.
• Если модуль еще не установлен, нажмите «Установить» и дождитесь завершения установки.
• Откройте карточку установленного модуля, выберите «Управлять», затем перейдите в «Настройки».
• Заполните обязательные поля, сохраните настройки и включите модуль переключателем.

Настройка модуля

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

• «API-ключ 2GIS». Обязательное секретное поле. Вставьте значение из кабинета провайдера и не публикуйте его в описаниях, письмах или открытых страницах.
• «Язык карты». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Значение по умолчанию: ru.

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

Проверка перед запуском

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

Частые ошибки

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

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