Интеграция с сервисом «DaData»

«DaData.ru» — сервис, предоставляющий через API данные о геопозиции объектов в систему Бипиум для проверки корректности их заполнения и их единого форматированного ввода в систему.

1. Принцип работы

При создании поля типа «Адрес» и его заполнении уникальным токеном сервиса «DaData.ru» в структуре каталога, система настраивается на работу с сервисом «DaData.ru». Далее, при заполнении поля «Адрес», система обращается к сервису «DaData.ru» по заполненному ранее токену и выводит перечень подходящих адресов в виде списка. При выборе значения из списка, Бипиум автоматически заполняет поле в корректно отформатированном виде.

2. Реализация

2.1. Получение токена сервиса «DaData.ru»

Перейдите на страницу сервиса «DaData.ru». Нажмите на кнопку «Войти»:

Далее, кликните по ссылке «Зарегистрируйтесь»:

Заполните все необходимые поля для регистрации в открывшейся форме и нажмите на кнопку «Зарегистрироваться»:

Завершите процесс регистрации и авторизуйтесь под данными своей учетной записи. Далее прокликайте шапку страницы в следующем порядке:

В поле «API-ключ» секции «Ключи» хранится уникальное значение API-ключа для доступа к сервису, которое необходимо использовать в Бипиуме в дальнейшем. Поле, значение которого необходимо сохранить:

2.2. Заполнение данных в структуре Бипиума

Откройте в вашей системе Бипиума каталог, в котором необходимо зафиксировать адрес и добавьте в него поле типа «Адрес». Добавленное в структуру каталога поле выглядит следующим образом:

На место плейсхолдера «токен DaData.ru» вставьте токен сервиса «DaData.ru», полученный на предыдущем этапе. Пример заполнения:

Сохраните изменения в каталоге.

3. Тестирование

Откройте карточку создания записи в измененном на предыдущем шаге каталоге. В созданное поле с типом «Адрес» начните писать существующее местоположение. Под полем для ввода откроется список с предложенными вариантами адреса:

Выделите подходящий вариант из списка и кликните на него. Система автоматически заполнит поле нужным адресом в правильном формате: