
GeoIP API: определение местоположения по IP
Готовое решение GeoIp Api для 1С-Битрикс. Определяйте местоположение посетителей и автоматически настраивайте контент. Установлено более 1000 раз. Купите.
Нужна лицензия 1С-Битрикс?
Поможем купить новую лицензию или продлить действующую — «1С-Битрикс: Управление сайтом» и Битрикс24.
Технические данные
- Опубликовано:
- 10.12.2016
- Обновлено:
- 01.06.2026
- Версия:
- 1.5.3
- Установлено:
- Более 1000 раз
- Подходящие редакции:
- «Первый сайт», «Старт», «Стандарт», «Малый бизнес», «Бизнес», «Корпоративный портал», «Энтерпрайз»
- Адаптивность:
- Да
- Поддержка Композита:
- Да
- Совместимо с Сайты24
- Нет
Онлайн-демонстрация
Хотите увидеть продукт в действии? Запросите демонстрацию — мы покажем всё вживую и ответим на вопросы.
Возможности GeoIP API
GeoIp Api — это готовое решение для CMS 1С-Битрикс, которое предоставляет разработчикам и владельцам сайтов программный интерфейс для автоматического определения географического местоположения посетителя по его IP-адресу. Продукт предназначен для сбора данных о стране, регионе, городе и координатах пользователя без необходимости самостоятельной интеграции со сторонними сервисами. Решение работает с любой редакцией платформы — от «Первого сайта» до «Энтерпрайз», поддерживает адаптивную верстку и композитный режим кеширования, что гарантирует высокую скорость работы даже при активном использовании геоданных.
Возможности и принцип работы
Модуль обращается к службам геолокации в порядке приоритета: Sypex Geo, IpGeoBase (отключена) и FreeGeoIp (отключена). По умолчанию данные берутся из первого успешного источника, но при необходимости можно явно указать конкретную службу. После установки модуль автоматически определяет IP текущего пользователя и сохраняет результат в cookies, что снижает количество повторных запросов и ускоряет работу сайта. В ответ на запрос API возвращает структурированный набор данных, который включает:
- Название города
- Название страны на языке сайта
- ISO-код страны
- ID страны в CMS 1С-Битрикс (совместим с функцией GetCountryArray)
- Название региона
- ISO-код региона (опционально)
- Название района (опционально)
- Широту и долготу
- Диапазон IP-адресов (опционально)
Для службы Sypex можно указать язык вывода данных (например, русский или английский) с помощью дополнительного параметра. Если IP не передан явно, модуль определяет местоположение по текущему адресу посетителя.
Что получает покупатель после установки
После приобретения и установки решения на сайт под управлением 1С-Битрикс вы получаете готовый API-метод для вызова из любого компонента или шаблона. Модуль не требует сложной настройки: достаточно указать предпочтительную службу геолокации, и система начнёт корректно обрабатывать запросы. В результате вы сможете:
- Автоматически подставлять город или регион в формы заказа, корзину, контактные данные
- Отображать контент, адаптированный под локацию пользователя (акции, склады, цены)
- Собирать статистику по географии аудитории для аналитики
- Интегрировать данные с любыми кастомными скриптами и сервисами
Версия модуля 1.5.2 (от 22.05.2025) уже прошла более 1000 установок, что подтверждает её стабильность и востребованность.
Для кого подходит решение
Продукт будет полезен интернет-магазинам, региональным порталам, агрегаторам, сервисам с привязкой к адресу доставки, а также любым проектам, где требуется персонализация контента по местоположению. Благодаря поддержке всех редакций 1С-Битрикс и отсутствию требований к специфическим настройкам хостинга, модуль одинаково эффективен как для малого бизнеса на редакции «Старт», так и для крупных корпоративных решений на «Энтерпрайз». Если вам нужно быстро и без лишних затрат внедрить геолокацию на сайте — это готовый инструмент, который работает «из коробки».
В местоположение входят:
- название города;
- название страны на языке сайта;
- iso-код страны
- id страны в CMS 1С Битрикс (соответствуют id стран, возвращаемых функцией GetCountryArray)
- название региона;
- iso-код региона (опционально);
- название района (опционально);
- ширина и долгота;
- диапазон ip-адресов (опционально).
В обычном режиме решение предоставляет данные из первой службы, корректно вернувшей данные. Службы вызываются в следующем порядке:
- sypexgeo.net (Sypex);
- ipgeobase.ru (IpGeoBase); (отключена, т.к. перестала отвечать)
- freegeoip.net (FreeGeoIp). (отключена, т.к. свободный api был закрыт)
Пример использования:
Указание сервера для Sypex
Список всех серверов https://sypexgeo.net/ru/api/
Указание ключа доступа для Sypex
\Bitrix\Main\Config\Option::set('rover.geoip', 'sypex-key', 'abcd1');
Компоненты
Указатель местоположения пользователей (rover:geoip.user.location)
Позволяет установить местоположение для пользователей на основе данных из модуля. Местоположение определяется по ip-адресу, с которого они впервые зашли на сайт.
Полное описание api на гитхабе проекта: https://github.com/pavelshulaev/geoip

Для чего используется GeoIP API на сайте на 1С-Битрикс?
С какими редакциями 1С-Битрикс совместим модуль?
Какова стоимость и условия лицензирования продукта?
Сложно ли установить и настроить модуль?
Как организована техническая поддержка после покупки?
Установка модуля из Маркетплейса
Перейдите в административной панели сайта в раздел «Маркетплейс» → «Каталог решений». Найдите модуль «GeoIP API: определение местоположения по IP» и нажмите «Установить». После завершения установки перейдите в раздел «Установленные решения», чтобы убедиться, что модуль появился в списке.
Настройка источников геоданных
Откройте «Настройки» → «Настройки модуля» и выберите «GeoIP API». В параметрах модуля укажите порядок использования служб геолокации (по умолчанию: Sypex Geo, IpGeoBase и FreeGeoIp). При необходимости отключите недоступные или платные источники, сняв соответствующие флажки.
Проверка базовой работы модуля
Сохраните настройки и перейдите на любую публичную страницу сайта. Откройте инструменты разработчика браузера (вкладка «Сеть» или «Cookies») и убедитесь, что после загрузки страницы в cookies появились данные о местоположении (например, city, country). Это подтверждает, что модуль определил IP посетителя.
Интеграция API в шаблон сайта
Для вывода геоданных на сайте используйте вызов API модуля в файлах шаблона (например, в header.php или footer.php). Добавьте код, который получает массив с данными о городе, стране и координатах через стандартный метод модуля. Результат можно использовать для персонализации контента (например, отображения города пользователя).
Настройка кеширования и производительности
Убедитесь, что модуль корректно работает с композитным режимом кеширования. В настройках модуля включите опцию «Сохранять результат в cookies» (если доступна), чтобы снизить количество повторных запросов к службам геолокации. Проверьте скорость загрузки страницы с помощью встроенных инструментов Битрикса или Google PageSpeed.
Финальная проверка работы модуля
Зайдите на сайт с другого IP-адреса (например, через VPN или мобильную сеть) и убедитесь, что геоданные обновились. В административной панели откройте журнал событий модуля (если предусмотрен) и проверьте отсутствие ошибок подключения к службам. Если всё работает корректно, модуль готов к эксплуатации.
- v1.5.301.06.2026— исправлены найденные уязвимости
- v1.5.222.05.2025— исправлены найденные уязвимости
- v1.5.106.02.2022— добавлена возможность задавать максимальное время ожидания от geoip-сервиса. По умолчанию 200 мс.
- v1.5.013.10.2021— единственным сервисом для определения местоположения установлен Sypex (остальные на данный момент не работают)
— добавлена возможность подключаться к Sypex по ключу (при регистрации/подписке)
— время ожидания ответа сервиса сокращено с 2 до 0,2 секунд. - v1.4.1103.06.2021— исправлены ошибки в преобразовании кодировки ответов для сайтов в windows-1251
— минимальная версия php повышена до 7.2
— рефакторинг - v1.4.913.04.2020— добавлена возможность задать региональный сервер для Sypex
— минимальна яверсия php повышена до 5.4
— прочие незначительные улучшения и доработки - v1.4.807.01.2019уменьшено время ожидания ответа от сервисов определения местоположения
- v1.4.716.07.2018Гео-запрос не производится, если страницу открывает бот
- v1.4.505.07.2018Добавлена возможность указать желаемый язык ответа, пока работает только для службы Sypex
Служба FreeGeoIp отключена, т.к. они закрыли свободный api - v1.4.424.05.2018В компонент определения местоположения пользователей добавлена проверка наличия модуля "Веб-аналитика"
Нужна помощь с установкой?
Напишите нам — поможем установить и настроить модуль на вашем сайте.
















