Текущая версия 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
Необязательность индекса ГАР
SDK работает не только с российскими адресами!
Поэтому индекс ГАР не обязателен для работы SDK - адреса будут выделяться и нормализовываться без индекса.
Но при этом не будет делаться сопоставление объектам ГАР и соответствующая корректировка
(например, в названии улицы допустили ошибку, но алгоритм сопоставил с улицей из ГАР и исправил ошибку при нормализации).
Если аналог российского ГАР существует или удастся получить для других стран, то поддержим его!
Сервер и минимальная клиентская версия
SDK Address содержит внутри себя всё необходимое для полноценной обработки.
То есть при встраивании кода SDK в конечное приложение оно может обрабатывать адреса автономно.
Однако есть возможность делать такую обработку не в приложении, а во внешнем сервере Address.Server, который
под .NET Core может запускаться под любой операционной системой.
Для SDK под Python и Javascript это ускорит обработку в разы. Для C# и Java тоже может быть резонным
вынести обработку вовне. В самом SDK достаточно в базовом классе задать URL сервера, и вместо локальных
вычислений всё будет отправляться на сервер, при этом результат получается эквивалентный.
Если обработка планируется только через сервер, то не обязательно брать SDK целиком.
Для этого предлагается минимальная (клиенская) версия SDK, в которой остались только нужные адресные
классы и взаимодействие с сервером, всё остальное убрано.
Размещение и корректировка кода
Актуальный код находится только на этом сайте. Мы ничего не размещаем в GitHub и не поддерживаем актуальность
на каких-либо внешних ресурсах.
Отметим, что это - генерируемый код, поэтому вносить изменения в него не стоит, так как следующая версия
кода перезатрёт эти изменения. О замеченных ошибках и доработках лучше сообщать разработчикам.
Огромное спасибо всем, кто присылает такие замечания!
Присылайте адреса!
Просьба ко всем, у кого есть коллекции адресов - поделитесь! Мы на них отлаживаем и совершенствуем алгоритмы. Присылайте в Excel, CSV или TXT (один адрес в строке).