Pullenti Address SDK

Адресный микросервис для разработчиков

Он-прем / закрытые контуры / SDK & микросервис

Нормализация российских адресов
как часть вашей архитектуры, а не чужой API

Pullenti Address — это движок нормализации и разборки русскоязычных адресов,
который ставится внутрь вашего контура. Он разбирает «живые» строки,
сопоставляет их с государственными реестрами и готовит данные для любых
карт и систем доставки.

Запросить демо
Смотреть пример интеграции
Примеры использования

Без зависимости от чужих лимитов и стабильности внешнего API. Полный контроль над данными и релизами.

Пример нормализации

SDK → ваш сервис

// входящая строка

Самарская обл., г. Самара, Кировский р-н, 17 км Московского шоссе, здание 2В

// результат SDK

{
  "region": "Самарская область",
  "city": "Самара",
  "district": "Кировский",
  "road_km": 17,
  "street": "Московское шоссе",
  "building": "2В",
  "gar_guid": "...",
  "geo": {
    "lat": 53.2043,
    "lon": 50.1418
  },
  "quality": "high"
}

SDK разбирает адрес до структурированных полей, привязывает к государственным реестрам
и возвращает координаты. Дальше вы сами решаете, с какими картами и системами работать.

Зачем, если уже есть облачные сервисы адресов?

Большинство решений по адресам — это внешние облачные API. Удобно на старте, но неудобно,
когда ваша система переросла «игрушечный» масштаб, работает в закрытом контуре или
должна опираться на несколько реестров сразу.

Зависимость от внешнего контура

Любая деградация внешнего сервиса = деградация ваших бизнес-процессов. Ограничения по лимитам,
изменения тарифов и правовые риски живут вне вашего контроля.

Нет он-прем и гибкости

Закрытые контуры, банковская сфера, гос-системы, критичная логистика — не всегда могут ходить
во внешнее облако за каждым адресом. Нужен модуль, который живёт рядом с вашей системой.

Адрес как «одно поле»

Многие сервисы отлично работают, пока адрес аккуратно введён в одно поле.
Но реальные системы живут на выгрузках, документах, Росреестре и «грязных» строках.

Что делает Pullenti Address SDK

Это не просто геокодер. Это модуль адресного домена: от извлечения адресов из текста до
нормализации по государственным реестрам и подготовки данных для ваших систем.

Глубокий разбор русских адресов

Нормализация с учётом регионов, районов, населённых пунктов, километров трасс,
корпусов, строений, литер. Поддержка сложных и нестандартных форматов.

Работа с «грязными» источниками

Вход — произвольные строки, документы, выгрузки. SDK извлекает адреса из текста,
а не только из аккуратно заполненных полей формы.

Он-прем и микросервис

Развёртывание в вашем контуре: как библиотека или отдельный сервис.
Версионирование вместе с вашей системой, интеграция в CI/CD.

Сопоставление с ГАР ФИАС

Привязка к реестру ГАР ФИАС. Возможность обогащать результат собственными справочниками и внутренними идентификаторам.

Готовность к большим объёмам

Обработка потоков и пакетных выгрузок, подготовка витрин, массовое приведение
адресов к единому формату.

Независимость от карт

SDK возвращает структурированные данные и координаты. Вы сами выбираете, какие карты,
маршрутизаторы и витрины на них строить.

Кому особенно заходит такой подход

Там, где адрес — не просто поле анкеты, а часть бизнес-процесса и отчётности.

CRM / ERP / биллинг

Единый формат адресов в системе. Меньше дублей, ошибок и ручных правок при интеграциях
и отчётности.

Логистика и сервисные компании

Корректная привязка точек обслуживания, складов, маршрутных листов.
Меньше «приехали не туда».

Финтех и гос-системы

Требования к точности адреса на уровне регулятора. Нормализация и привязка
к реестрам внутри периметра.

Платформы и конструкторы

Адресный модуль как часть платформы. Один раз интегрировать — многократно переиспользовать
в решениях для клиентов.

Как это выглядит для разработчика

Pullenti Address можно подключить как библиотеку или HTTP-сервис.
Ниже — условный пример обращения к локальному эндпоинту нормализации.

# пример запроса к локальному сервису

POST http://address-sdk.local/normalize
Content-Type: application/json

{
  "query": "Самарская обл., г. Самара, 17 км Московского шоссе, здание 2В",
  "options": {
    "needGeo": true,
    "needRegistryIds": true
  }
}

// ответ (сокращён)

{
  "normalized": {
    "region": "Самарская область",
    "city": "Самара",
    "street": "Московское шоссе",
    "road_km": 17,
    "building": "2В"
  },
  "registry": {
    "garGuid": "..."
  },
  "geo": {
    "lat": 53.2043,
    "lon": 50.1418
  },
  "quality": "high"
}

Подробнее о SDK

Лицензия, поддерживаемые языки и работа с индексом ГАР.

Лицензии

Бесплатно для некоммерческого использования (индекс только по Москве). Коммерческая версия — бессрочная, без ограничений по инсталляциям, с полным индексом ГАР ФИАС и утилитой обновления.

Языки и платформы

SDK доступен на C#, Java, Python3 и Node.js. Код функционально идентичен на всех языках благодаря конвертеру Unisharping.

Индекс и координаты

Индекс ГАР строится локально (примерно 23 ГБ). Без него выделение и нормализация адресов работают, но сопоставление и координаты доступны при загрузке. Покрытие координат — около 64 % домов и 60 % земельных участков по России (71 % домов и 87 % участков по Москве).

Обсудим ваш кейс с адресами

Расскажите, где у вас живут адреса: в заявках, договорах, выгрузках, Росреестре,
логистике или CRM. Подготовим короткий прототип под ваш реальный набор данных.

Обычно достаточно 1–2 итераций, чтобы показать разницу между «просто API адресов»
и адресным модулем, встроенным в вашу архитектуру.