Очистить и стандартизировать адрес (DaData)

Что делает робот

Робот принимает адрес в любом виде — «мск тверская 7», «Большая Пушкарская 5», «спб пушкарская б. д5» — и возвращает его в стандартном написании плюс разложенным по полям: индекс, регион, город, улица, дом, квартира, коды ФИАС и КЛАДР, координаты. Стандартизация идёт через сервис DaData, в основе — справочник ФИАС.

Типичная пара на входе и выходе: «мск тверская 7» превращается в «г Москва, ул Тверская, д 7», и каждый кусок доступен отдельным полем для записи в CRM.

Настройка

Полей три:

• Адрес — строка в свободной форме. Подставляется из поля сделки, реквизитов компании, формы на сайте;
• API Ключ DaData и Secret Ключ DaData — обязательны. Берутся в личном кабинете dadata.ru, работают только вместе. В отличие от робота «Найти организацию по ИНН (DaData)», здесь нет запасных ключей приложения: без своей пары робот не запустится.

Что возвращает

Помимо стандартизованной строки адреса робот отдаёт около сотни полей. Группами:

• Иерархия адреса — страна и её ISO-код, федеральный округ, регион, район, город, населённый пункт, улица, дом, строение, квартира. Каждый уровень с типом («ул», «пр-кт») и кодами ФИАС/КЛАДР;
• Индекс и коды — почтовый индекс, ОКАТО, ОКТМО, код налоговой инспекции;
• Геоданные — широта и долгота, часовой пояс, признак нахождения внутри МКАД или КАД и расстояние до кольца, ближайшие станции метро списком;
• Маркеры качества — коды qc: распознан ли адрес полностью, подтверждён ли дом, насколько точные координаты. Отдельным полем приходят нераспознанные куски исходной строки — по ним видно, что адрес разобран не до конца.

Сценарии из практики

Нормализация адресов доставки. Клиенты пишут адрес как попало: «СПб, Пушкарская, 5», «питер большая пушкарская д. 5». Перед передачей в службу доставки робот приводит адрес к единому виду и отдаёт индекс и координаты — курьерская служба получает чистые данные, менеджер не вычитывает каждый заказ.

Сегментация базы по географии. Процесс пробегает по компаниям, робот раскладывает адреса по полям. Дальше условия: регион «Свердловская область» — в восточную команду продаж, Москва внутри МКАД — в центральную. Работает и на старой базе, где адреса заводили годами вручную.

Контроль качества адреса при оформлении документов. Перед генерацией договора робот проверяет юридический адрес: если код qc показывает неполное распознавание или дом не подтверждён, сделка останавливается, ответственному идёт задача сверить адрес с выпиской. В договор не попадает «город у фонтана».

Почтовые отправления без возвратов. Для бумажной рассылки критичен корректный индекс — по нему сортировочные центры маршрутизируют письма. Робот достаёт индекс из справочника, а не из рук менеджера: доля возвратов «адресат не значится» заметно падает. Заодно поле часового пояса помогает звонить клиентам в рабочее время по их месту.

Типичные ошибки

«Не указаны API или Secret ключ». Ключей нет или заполнено только одно поле из пары. API и Secret работают только вместе — скопируйте оба из профиля на dadata.ru.

«Пустой адрес». В параметр пришла пустая строка: переменная не подставилась или поле адреса в карточке не заполнено. Ставьте условие на непустое значение до вызова робота.

Адрес вернулся с пустыми полями. DaData не смогла распознать часть строки — например, опечатка в названии улицы или новостройка, которой ещё нет в ФИАС. Смотрите коды qc и поле нераспознанных частей: они прямо скажут, что пошло не так.

«Ошибка DaData: …». Причина в тексте: неверный ключ, исчерпан лимит запросов на сутки или сервис недоступен. Лимит на бесплатном тарифе маленький — для пакетной чистки базы считайте объёмы заранее.