Геолокация по IP без лимитов (Sypex Geo)

Что умеет решение

Модуль подключает к штатной геолокации 1С-Битрикс (раздел Настройки → Настройки продукта → Геолокация) обработчик «Sypex Geo City (локальная база)». Страна, регион и город посетителя определяются по локальному файлу базы данных на сервере. Это исключает необходимость обращения к внешним API, использования ключей доступа и снимает ограничения на количество запросов.

Стандартный обработчик SypexGeo требует подключения к онлайн-API: без регистрации доступно 10 000 запросов в месяц. При превышении лимита или сбое сервиса определение города прекращается. Данный модуль выполняет определение на стороне сервера, полностью независимо от внешних сервисов.

Функционал обеспечивает автоматическое определение города для регионализации готовых решений (например, «Аспро»), корректную подстановку местоположения при оформлении заказа в модуле «Интернет-магазин» и работу любого кода, использующего класс \Bitrix\Main\Service\GeoIp\Manager, непосредственно с локальной базы без необходимости доработки или изменения шаблонов.

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

Модуль обеспечивает автоматическое обновление базы геолокации: агент проверяет наличие новой версии на sypexgeo.net раз в сутки и скачивает её только при обнаружении изменений. Перед заменой новая база проходит проверку контрольным поиском, что гарантирует непрерывность работы сайта. На странице настроек отображается состояние базы (дата сборки, размер, даты последней проверки и загрузки), доступны кнопки ручного обновления и повторной загрузки, а также инструмент для проверки любого IP-адреса с выводом ответа локальной базы и итогового результата геолокации. Также настраивается порядок опроса обработчиков. Установка выполняется в два шага: при активации модуля база загружается сразу, а штатный онлайн-обработчик SypexGeo можно отключить по желанию. При удалении модуля база и настройки сохраняются, а отключенный онлайн-обработчик можно включить обратно. Решение работает в многосайтовой конфигурации, предоставляя единую геолокацию для всех сайтов установки. Для корректной работы требуются PHP версии 8.2 и выше, главный модуль с поддержкой геолокации (\Bitrix\Main\Service\GeoIp), около 40 МБ свободного места в директории /upload, возможность исходящих HTTPS-запросов к sypexgeo.net для загрузки базы и расширение PHP zip (ZipArchive) для распаковки архива.

Модуль использует базу геолокации Sypex Geo City, которая загружается с сайта sypexgeo.net. Это бесплатная база под лицензией BSD, она не включена в архив модуля и скачивается отдельно. Данные о посетителях и сайте никуда не передаются; модуль выполняет только загрузку файла базы.

Поддерживаются только IPv4-адреса. Геолокация для IPv6 и локальных адресов не определяется, и запрос передаётся следующему обработчику в списке.

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

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

Модуль успешно прошёл проверку по методике marketplace-security-skills 1С-Битрикс: статус в файле security-journal.json установлен как ready_for_submission.

«Геолокация по IP без лимитов (Sypex Geo)» можно подключить с помощью General iT: установить модуль, настроить его и убедиться, что интеграция работает корректно.