+7 499 938 8452 пн.-пт. 10:00 – 17:00

GeoIp Api




Начиная с версии 2.0.0 модуль умеет расширяться без правки кода: список geoip-служб и порядок их вызова собираются через событие onBuildServiceList. Подключайте собственные geoip-службы из других модулей — достаточно зарегистрировать обработчик события и вернуть полное имя класса своей службы.
Подробнее в репозитории проекта.

Модуль предоставляет API для определения местоположения по IP-адресу. При отсутствии явного указания адреса определение производится по текущему IP пользователя. Информация о последнем IP-адресе сохраняется в cookies для снижения количества запросов.

Если у вас истекла лицензия Битрикса, то можете скачать модуль с github

Включаемые данные о местоположении
  • название города
  • название страны на языке сайта
  • ISO-код страны
  • ID страны в CMS 1С-Битрикс
  • название региона
  • ISO-код региона
  • широта и долгота
  • название района*
  • диапазон IP-адресов*

*не заполняется встроенной службой Sypex; поле доступно, только если данные предоставляет сторонняя geoip-служба, подключённая через событие onBuildServiceList.

Используемые службы определения местоположения

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

  • sypexgeo.net (Sypex) — активна по умолчанию.
Службы ipgeobase.ru (IpGeoBase) и freegeoip.net (FreeGeoIp) удалены из модуля, т.к. оба сервиса прекратили работу и не предоставляют публичный API. Разработчики могут подключить собственную geoip-службу через событие onBuildServiceList, не изменяя код модуля.

Компоненты

Указатель местоположения пользователей (rover:geoip.user.location) — позволяет установить местоположение для пользователей на основе IP-адреса, с которого они впервые зашли на сайт. Доступен только администраторам. Для работы необходим установленный модуль «Веб-аналитика».


Полное описание api и примеры использования на гитхабе проекта: https://github.com/pavelshulaev/geoip


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

Если модуль был вам полезен, вы можете оставитьпожертвование тут ❤️ или тут❤️


Каталог для ИИ