Текущая версия SDK Pullenti Address: 4.35 от 1 ноября 2026 года

SDK Address C#
SDK Address Java
SDK Address Python3
SDK Address JavaScript (Node.js)

Сервер Address (.NET Core)
App
Демо-стенд Address (под Windows)
App
Индекс ГАР (77 регион)
Gar Index (от 09.10.2026)

Замечания по использованию

Использование документации - распаковать архив и запустить index.html в любом браузере. Эта же самая документация есть на вкладке Документация.
Использование кода в своём проекте - см. раздел "Использование SDK" на вкладке Overview документации. Для каждого языка zip-архив кода содержит коды самого Pullenti Address и код простого консольного приложения Demo, использующего SDK. В конечный проект нужно добавлять только папку Pullenti, без консольного кода.

Индекс объектов ГАР

Объекты ГАР ФИАС, с которыми работает SDK Address, располагаются в индексе ГАР. Индекс для всей России и любого подмножества регионов можно получить из xml-файлов ГАР с помощью конвертера, который входит в коммерческую версию SDK. Архив индекса 77-го региона (Москва) можно скачать здесь. Для работы демо-примера нужно распаковать индекс ГАР в папку, указанную в документации (или в любое локальное место, а папку подправить в коде Program).

Изменения в версиях

4.35

  • Оптимизирована структура индекса, обновлять нужно индекс и код SDK одновременно - обратной совместимости нет;
  • Сделан новый сервер Address.Webserver.dll со встроенным Swagger и поддерживающий OpenAPI, теперь можно обрабатывать адреса без кода SDK, общаясь с сервером на уровне запросов http и получая данные в json;
  • Полностью убрали блок "Адрессарий", который вроде оказался невостребованным;
  • Координаты Gps вынесены из параметров GarObject в поле GarObject.Gps типа GarObject;
  • Коды ФИАС (guid) убраны из GarObject.Guid, они заменены на более современные коды ГАР (int), для чего добавлено поле GarObject.ObjectIds - это массив int, так как в принципе объект ГАР может иметь несколько кодов (см. документацию). Коды ФИАС можно получить через функцию GetParamValues как и все другие дополнительные параметры типа кадастрового номера, разных кодов, года постройки и пр.
  • Значений некоторых параметров у объекта в принципе может быть несколько, поэтому вместо функции GetParamValue, возвращающей строку, теперь функция GetParamValues, возвращающая массив строк;
  • В индексе появились так называемые виртуальные объекты, которые отсутствуют в исходной ГАР, но которые пришлось ввести по ряду причин (подробности см. в документации в разделе "Объекты ГАР"). У таких объектов список ObjectIds пустой;
  • Массовую обработку можно ускорить в несколько раз, если предварительно отсортировать массив адресов в лексикографическом порядке, чтобы дома на одной улице были в соседних строках. Тогда если установить опцию ProcessTextParams.AccelerateProcess = true, то обработка может ускориться в разы, так как при ранее разобранной улице из предыдущего адреса в соседнем адресе будет привязываться только дом;
  • В целом улучшено качество выделения, все присланные ошибки исправлены.
4.34
  • Доработано распознавание адресов, заданных латиницей (типа Moscow, ul.Pervomaiskaya d.2)
  • В целом улучшено качество выделения, все присланные ошибки исправлены.
4.33-4.29
  • Детализация сообщений при разборе адреса - в TextAddress добавлен массив Messages объектов класса Message.
  • В целом улучшено качество выделения, все присланные ошибки исправлены.
4.28
  • Добавлены Min-версии SDK, которые работают только с сервером, то есть вся обработка делается через AddressServer, а само SDK содержит только адресные классы и процедуры взаимодействия с сервером.
  • Параметр Gps переименован в GpsPoint, AreaGps - в GpsRectangle. Покрытие в среднем по России сейчас около 64% домов и 60% земельных участков (для Москвы 71% и 87%).
  • В целом улучшено качество выделения, все присланные ошибки исправлены.
4.27
  • Классы GpsPoint и GpsRectangle переделаны в один класс GpsObject.
  • В целом улучшено качество выделения.
4.26
  • В поисковые параметры SearchParams добавлено поле FullText для реализации поискового механизма по ГАР-объектам как и на сайте Налоговой: вводим начало адреса, в выпадающем списке варианты, выбираем вариант, который заносится в поисковое поле, далее вводим следующий адресный элемент и т.д.
  • В поиске по значениям атрибутов поддержали ObjectId (числовой идентификатор ГАР-объекта).
  • В целом улучшено качество выделения.
4.25
  • Загружены GPS из Росреестра. Добавлены классы GpsPoint и GpsRectangle.
  • В целом улучшено качество выделения.
4.24
  • Добавлен класс AddressDbRecord, который предлагается использовать для представления нормализованных адресов в реляционной СУБД с возможностью последующего поиска SQL-запросами. Подробности в документации.
  • Начался процесс поддержки координат GPS - пока есть для около трети регионов.
  • В целом улучшено качество выделения.

Необязательность индекса ГАР

SDK работает не только с российскими адресами! Поэтому индекс ГАР не обязателен для работы SDK - адреса будут выделяться и нормализовываться без индекса. Но при этом не будет делаться сопоставление объектам ГАР и соответствующая корректировка (например, в названии улицы допустили ошибку, но алгоритм сопоставил с улицей из ГАР и исправил ошибку при нормализации).
Если аналог российского ГАР существует или удастся получить для других стран, то поддержим его!

Сервер и минимальная клиентская версия

SDK Address содержит внутри себя всё необходимое для полноценной обработки. То есть при встраивании кода SDK в конечное приложение оно может обрабатывать адреса автономно.
Однако есть возможность делать такую обработку не в приложении, а во внешнем сервере Address.Server, который под .NET Core может запускаться под любой операционной системой. Для SDK под Python и Javascript это ускорит обработку в разы. Для C# и Java тоже может быть резонным вынести обработку вовне. В самом SDK достаточно в базовом классе задать URL сервера, и вместо локальных вычислений всё будет отправляться на сервер, при этом результат получается эквивалентный.
Если обработка планируется только через сервер, то не обязательно брать SDK целиком. Для этого предлагается минимальная (клиенская) версия SDK, в которой остались только нужные адресные классы и взаимодействие с сервером, всё остальное убрано.

Размещение и корректировка кода

Актуальный код находится только на этом сайте. Мы ничего не размещаем в GitHub и не поддерживаем актуальность на каких-либо внешних ресурсах.
Отметим, что это - генерируемый код, поэтому вносить изменения в него не стоит, так как следующая версия кода перезатрёт эти изменения. О замеченных ошибках и доработках лучше сообщать разработчикам. Огромное спасибо всем, кто присылает такие замечания!

Присылайте адреса!

Просьба ко всем, у кого есть коллекции адресов - поделитесь! Мы на них отлаживаем и совершенствуем алгоритмы. Присылайте в Excel, CSV или TXT (один адрес в строке).