Текущая версия SDK Pullenti Address: 4.28 от 02 февраля 2025 года

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

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

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

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

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

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 - пока есть для около трети регионов.
• В целом улучшено качество выделения.

4.23

• В индексе поддержаны переименования улиц и населённых пунктов (эта информация берётся из КЛАДР формата dbf, которая также выкладывается на сайте ФНС и информация о чём отсутствует в xml-версии).
• Также улучшено выделение адресов советского периода, где всякие АССР и т.п.
• Учтены некоторые специфические случаи, например, когда не указывают населённый пункт, но при этом есть почтовый индекс.
• В адресах встречается ситуация, когда в одном поле ввода 2 адреса (например, прописки и проживания) - такие случаи теперь обрабатываются и второй адрес заносится в поле SecondAddress класса TextAddress.
• И в целом улучшено качество выделения.

4.21

• Переделаны алгоритмы работы со зданиями и помещениями. В RoomAttributes добавлено поле string Misc, в которое помещается возможная специфика (например, "пом.10 моп" в Misc запишется "МОП" - место общего пользования).
• Функция GetObjects у AddressService переименована в GetChildrenObjects.
• Поддержали некоторую специфику адресов Киргизии.
• Улучшено качество выделения.

4.19

• Вместо класса DetailParams у AddrObject теперь поля DetailTyp и DetailParam, моделирующие относительные указатели (типа "на 100 м. юго-восточнее"), а все остальные дополнительные элементы (этажи, а/я, индексы и пр.) теперь заносятся в словарь Params у всего адреса TextObject
• Улучшено качество выделения (на около 800 тыс. присланных разных примерах).

4.18

• Вместо функций Get/SetDefaultGarObject введён класс ProcessTextParameters, экземпляр которого подаётся вторым параметром в функции обработки (null - пустые значения). В нём можно указывать номера регионов по умолчанию и дефолтовый объект.
• Улучшено качество выделения (особенно экзотических объектов).

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

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

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

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

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

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

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

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