Разработка модуля геолокации 1С-Битрикс

Разработка модуля геолокации 1С-Битрикс

Геолокация — это не только «определить город». На сайте интернет-магазина геолокация влияет на доступность способов доставки, ассортимент (не все товары доставляются в регион), склад-источник отгрузки, контактный телефон в шапке, региональные акции. В Битрикс есть bitrix:geo для базового определения города, но он не интегрирован с каталогом, корзиной и кастомными компонентами — каждую связь нужно строить самостоятельно.

Архитектура

Модуль vendor.geo решает три задачи:

1. Определение региона — по IP, по геолокации браузера, по явному выбору пользователя
2. Хранение регионов — иерархия: страна → регион → город, со всеми метаданными
3. Применение — API для компонентов: текущий регион, фильтрация доставки, региональный контент

Таблицы ORM:

• b_vendor_geo_country — страны: id, name, iso2, iso3, phone_code
• b_vendor_geo_region — регионы/области: id, country_id, name, timezone
• b_vendor_geo_city — города: id, region_id, name, latitude, longitude, population
• b_vendor_geo_user_location — выбранный регион пользователя: user_id или session_id, city_id, detection_method (ip/browser/manual), created_at

Определение города по IP

Три варианта по убыванию точности и стоимости:

MaxMind GeoIP2 (рекомендуется для высокой точности):

$reader = new \GeoIp2\Database\Reader('/path/to/GeoLite2-City.mmdb');
$record = $reader->city($_SERVER['REMOTE_ADDR']);
$cityName   = $record->city->names['ru'] ?? $record->city->name;
$regionName = $record->mostSpecificSubdivision->names['ru'] ?? null;

ip-api.com (бесплатно, 45 req/min):

$data = json_decode(file_get_contents("http://ip-api.com/json/{$ip}?lang=ru&fields=city,regionName"), true);

dadata.ru (точнее для России):

// POST https://suggestions.dadata.ru/suggestions/api/4_1/rs/iplocate/address

Результат кешируется по IP-адресу на 24 часа. Для корпоративных сетей (один IP = весь офис) и CDN-прокси определение менее точное — в этих случаях результат помечается как low_confidence.

Попап подтверждения города

При первом визите показывается попап: «Ваш город — Москва?». Если пользователь нажимает «Нет, выбрать другой» — открывается модальное окно с поиском по городам:

GET /bitrix/components/vendor/geo.city-search/ajax.php?q=Красн
→ [{"id":12,"name":"Краснодар","region":"Краснодарский край"}, ...]

Поиск по b_vendor_geo_city.name с LIKE 'Красн%', предподготовленный индекс на колонке. Выбранный город сохраняется в cookie и b_vendor_geo_user_location.

Применение геолокации

Региональный телефон в шапке:

$city = \Vendor\Geo\GeoService::getCurrentCity();
$phone = RegionalPhoneTable::getByCity($city['ID']) ?? Option::get('vendor.geo', 'default_phone');

Фильтрация способов доставки:

В компоненте оформления заказа, перед отображением доставок, фильтруем по региону:

$deliveries = \Bitrix\Sale\Delivery\Services\Manager::getActiveList();
$cityId     = GeoService::getCurrentCityId();

$deliveries = array_filter($deliveries, function($delivery) use ($cityId) {
    $regions = DeliveryRegionTable::getAvailableRegions($delivery->getId());
    return empty($regions) || in_array($cityId, $regions);
});

Региональный склад для расчёта наличия:

Если магазин работает с несколькими складами, определяется ближайший по coordinates → haversine distance.

Региональный контент в инфоблоках

К элементам и разделам инфоблока можно привязать регионы видимости через HL-блок RegionBinding. Компонент vendor:geo.iblock.filter добавляет в запрос фильтр по текущему региону автоматически.

Сроки разработки

Итого: 7 рабочих дней. Геолокация через браузерный Geolocation API (GPS/WiFi) — +1 день.