Статьи о геокодинге, маршрутизации, AI-аналитике и работе с геоданными. Руководства, кейсы, новости платформы.
Пошаговая инструкция по интеграции API геокодинга Me3ka в ваш проект. От регистрации до первого ответа с координатами - с практическими примерами кода.
Шаг 1: Регистрируйтесь на me3ka.ru, получаете API-ключ. Шаг 2: Делаете GET-запрос к /api/geocode?q=ваш+адрес с заголовком X-API-Key. Шаг 3: Разбираете JSON-ответ. Это всё - десять строк кода на любом языке. В статье разбираем каждый шаг с примерами на JavaScript (fetch), Python (requests) и cURL. Также рассмотрим обработку ошибок и работу со скором уверенности.
ТехнологииТехническая история импорта полного государственного реестра адресов России в PostgreSQL за 11.4 часа. Архитектура, узкие места, оптимизации.
ФИАС ГАР - это ZIP-архив размером 50+ ГБ от ФНС России, внутри которого XML-файлы для каждого из 96 регионов. Скачивать весь архив нецелесообразно - мы написали скрипт, который читает содержимое ZIP через HTTP Range-запросы и скачивает только нужные файлы региона. Дальше - парсинг XML через SAX (не DOM, объем не позволяет), batch INSERT по 10 000 строк, параллельная обработка регионов. Итог: 38.4 млн домов в таблице gar_houses, 1.7 млн адресных объектов, 148 млн строк иерархии. Рассказываем обо всех граблях и как их обошли.
КейсКак служба доставки из Ростова-на-Дону автоматизировала обработку 500+ адресов в день с помощью пакетного геокодинга Me3ka.
До Me3ka: операторы вручную вводили каждый адрес в навигатор, на 500 заказов уходило 3 часа. Адреса из клиентских форм приходили в разных форматах: «ул Ленина 5», «Ленина пять», «5 Ленина». Курьеры иногда получали неправильные координаты и ехали не туда. После: пакетный геокодинг через API обрабатывает все заявки за 2 минуты, автоматически нормализует форматы, выдает скор уверенности. Адреса с низким скором (менее 0.6) флагируются для ручной проверки - таких около 3%. Скорость обработки выросла в 90 раз. Стоимость: 180 ₽ в день на тарифе Starter.
ОбновленияКрупное обновление платформы: добавлен AI-скоринг локаций, запущена маршрутизация через OSRM, обновлена карта с 3D-зданиями, выпущены бета-версии SDK.
Главные изменения версии 2.0: AI-скоринг (оценка бизнес-потенциала точки от 0 до 100 по 15+ факторам - плотность населения, конкуренция, транспортная доступность), маршрутизация OSRM (Южный федеральный округ, маршрут + матрица расстояний), обновленная карта с корректным отображением 3D-зданий, бета-версии Flutter SDK, Kotlin SDK для Android и Swift SDK для iOS, обновленный портал разработчика с playground для тестирования API. Тарифы также пересмотрены - новые лимиты и цены для Business и Pro.
ТехнологииПодробное объяснение алгоритма нечеткого поиска через триграммы PostgreSQL. Почему он лучше LIKE и регулярных выражений для поиска адресов.
pg_trgm (trigramm) - расширение PostgreSQL, которое разбивает строку на «триграммы» - все возможные подстроки длиной 3 символа. «Тверская» дает триграммы: «тве», «вер», «ерс», «рск», «ска», «кая». Функция word_similarity вычисляет число совпавших триграмм и возвращает значение от 0 до 1. GIN-индекс по триграммам позволяет выполнять similarity-запросы за 10-50 мс на миллионах строк. В статье: как настроить pg_trgm, выбрать правильный порог похожести, строить GIN-индексы и оптимизировать запросы для адресного поиска. Примеры SQL-запросов для геокодинга.
РуководствоСравнение двух российских адресных реестров. Почему ФИАС ГАР заменил КЛАДР и какие данные содержит каждый из них.
КЛАДР (Классификатор адресов Российской Федерации) создан в 2000-х годах для налоговых целей. ФИАС (Федеральная информационная адресная система) пришел ему на смену в 2011 году и с 2014 является единственным официальным государственным реестром. Главные отличия: ФИАС содержит более детальную иерархию (8 уровней против 5 у КЛАДР), поддерживает муниципальную и административную иерархии одновременно, регулярно актуализируется ФНС. КЛАДР официально устарел, но многие legacy-системы все еще его используют. Me3ka использует ФИАС ГАР (исторический вариант ФИАС, начиная с даты его запуска по настоящее время) - самую полную версию. В статье: схемы данных, коды регионов, примеры запросов.
РуководствоКак добавить интерактивную карту с векторными тайлами Me3ka на сайт или в веб-приложение. MapLibre GL JS, кастомный стиль, маркеры, геокодинг.
MapLibre GL JS - open-source библиотека для отображения векторных карт в браузере. Устанавливается через npm или CDN, занимает 300KB (сжатый). Подключение тайлов Me3ka: достаточно указать URL style.json в конструкторе карты. В style.json уже прописаны все источники (здания, дороги, POI, водоемы) и стили отображения. В статье рассматриваем: первичную инициализацию, добавление маркеров, геокодинговую строку поиска, обработку кликов по объектам, кастомизацию стилей (смена цветов, шрифтов, видимости слоев), работу с мобильными устройствами (touch-события, производительность).
КейсКейс: как розничная сеть кофеен использовала AI-аналитику Me3ka для выбора 5 новых точек открытия из 200 рассматриваемых адресов.
Задача: сеть из 15 кофеен планировала расширение на 5 новых точек в трех городах. Традиционный процесс с выездами на место занял бы 3-4 недели. Решение: загрузить 200 рассматриваемых адресов в пакетный скоринг-анализ Me3ka. За 20 минут получены скоры для всех адресов с разбивкой по факторам (демография, конкуренция, транспорт). Топ-20 адресов с высоким скором проверены полевыми исследованиями (2 дня). Итог: 5 точек успешно открылись, 4 из них превысили плановые показатели продаж в первые 3 месяца. Сэкономлено 3 недели аналитической работы.
ТехнологииТехнический разбор движка маршрутизации OSRM: как он предобрабатывает граф дорог OSM и строит маршруты за миллисекунды.
OSRM (Open Source Routing Machine) - один из самых быстрых open-source движков маршрутизации. Работает в три фазы: извлечение (osrm-extract) - преобразование OSM PBF-файла в граф дорог с атрибутами скоростей и ограничений; разбиение (osrm-partition) - разбиение графа на ячейки для MLD-алгоритма; настройка (osrm-customize) - привязка скоростных профилей. После предобработки маршрут строится алгоритмом MLD (Multi-Level Dijkstra) за 10-50 мс. В статье: архитектура OSRM, различия профилей car/foot/bicycle, работа с русскими дорожными данными OSM, настройка максимальной скорости для российских дорог.
РуководствоКак использовать Matrix API Me3ka для оптимизации маршрутов доставки. Задача VRP, алгоритмы и практическое применение.
Matrix API возвращает матрицу времени и расстояния от N источников до M назначений. Запрос одного вызова Matrix API (100x100 = 10 000 пар) занимает 200-500 мс. Это базовый инструмент для задачи VRP (Vehicle Routing Problem) - оптимального распределения заказов между курьерами. В статье: как формировать запрос к Matrix API, интерпретировать ответ (durations и distances), интегрировать с алгоритмом 2-opt для оптимизации маршрута, практический пример на Python с реальными данными 20 адресов и 3 курьеров. Алгоритм сокращает суммарный пробег на 15-25% по сравнению с последовательным назначением.
Новые статьи, обновления платформы и полезные руководства - не чаще двух раз в месяц. Без спама.