Текущая версия SDK Pullenti Address: 4.23 от 7 марта 2024 года

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

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

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

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

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

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 - пустые значения). В нём можно указывать номера регионов по умолчанию и дефолтовый объект.
• Улучшено качество выделения (особенно экзотических объектов).

4.17

• В адрес TextAddress теперь добавляется страна первым элементом
• Улучшено качество выделения (особенно загородных объектов).

4.16

• Вместо отдельного типа SpecialAttributes (которым моделировали указатели типа "на 200м к северу от ...") сделан класс DetailParams, в который помещаются все малозначимые атрибуты объекта (указатели, части, этажи и др.). Если у объекта AddrObject есть такие атрибуты, то они записываеются в поле Details.
• Улучшено качество выделения, особенно по работе с участками и различными территориями.

4.15

• Улучшено качество выделения. Подправлен коэффициент качества - теперь он не уменьшается при непривязке домов к ГАР (это довольно частая ситуация отсутствия домов в ГАР)
• Сделана обработка списков домов\помещений, когда их несколько в адресе, разделяемые запятыми или дефисами. Первый из них также заносится в Items, а остальные в AdditionalItems.

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

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

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

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

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

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