Как легко заполнить адрес без ошибок? Интеграция с сервисом kladr-api.ru

Довольно часто в организации приходится заполнять карточки организаций, контактных лиц или персон. И один из реквизитов, который должен быть заполнен – это почтовый или юридический адрес. От корректности и правильности заполнения адреса зависит, например, каким в итоге будет сформирован конверт для отправки корреспонденции в модуле Канцелярия.

Процесс заполнения адреса может быть довольно трудоемким. Дополнительно существует риск, что адрес будет внесен ошибочно в следствие человеческого фактора. Это обуславливается отсутствием централизованной базы адресов, вроде ФИАС или КЛАДР, в поставке DIRECTUM.

К счастью, в интернете существует довольно много сервисов, которые предоставляют возможность подбирать адрес по ключевым словам. Одним из таких является сервис kladr-api.ru. Он дает возможность производить поиск города, улицы, номера дома. Также сервис является бесплатным для некоммерческого использования.

Интересным, на мой взгляд, показалась возможность возвращать данные по введенному почтовому индексу. В частности, по индексу может быть однозначно определен город, область или край, а также район, к которому относится индекс. А дальше – больше. Можно получить список улиц, относящихся к полученному населенному пункту, а также список строений.

Рисунок 1 Выбор улицы

Все вышеописанное удалось оформить в простенький диалог. Пользователь вводит индекс и отправляет запрос на сервис. Ответ приходит в виде JSON объекта. Далее происходит разбор JSON и получение нужных нам данных, таких как регион, округ или район и город. Далее необходимо выбрать улицу. Важным будет замечание, что сервис позволяет выбрать только те улицы, которые закреплены за конкретным индексом. После указания улицы идет поиск номеров строений. В заключение остается ввести номер квартиры или офиса. На выходе мы получаем объект, который содержит все данные, необходимые для формирования строки адреса. Остается только чуть доработать под необходимую пользователю логику, например, подстановку в реквизит.

Рисунок 2 Выбор номера строения

Бесплатная версия сервиса имеет ограничение – 100000 запросов в день. Разработчики объясняют это заботой о производительности системы. Помимо этого, в ходе работы над диалогом я выяснил, что в запросе возвращается не более 400 строк. Поэтому список номеров строений может быть не полным. В этом случае пользователь может ввести номер строения самостоятельно.

Рисунок 3 Результат работы.

Все, что показано на рисунках, оформлено в пакет разработки, который прикреплен к статье. Можно свободно использовать его в своих системах с учетом ограничений, указанных на на этой странице.

Прикреплен файл: Интеграция с kladr-api_ru.zip