После установки приложение создаёт на портале новый тип поля "Адрес с Яндекс картой" и добавляет робота/действие бизнес-процесса для работы с данными в поле адреса.
![](https://app.lbtrm.ru/img/yandexmapfield/field2.png?1719993191522)
Указать адрес можно при помощи клика на карте или при помощи строки поиска, которая подскажет возможные варианты адресов и сохранит выбранный адрес в едином формате.
![](https://app.lbtrm.ru/img/yandexmapfield/field.png?1719993191522)
При отсутствии у объекта или места адреса (например, у строящихся объектов) можно указать координаты. В таком случае точка на карте будет установлена в соответствии с указанными координатами, а адрес заполнится с точностью до населённого пункта или наименования местности, к которой относятся координаты.
![](https://app.lbtrm.ru/img/yandexmapfield/fieldcoord.png?1719993191522)
Если на вашем
тарифе Битрикс24 доступны роботы или бизнес-процессы, данные из поля с картой при помощи робота и действия бизнес-процесса можно сохранить в отдельные текстовые поля для генератора документов или для передачи сервисам доставки, например.
![](https://app.lbtrm.ru/img/yandexmapfield/fieldsaved.png?1719993191522)
Перед установкой приложения, пожалуйста, ознакомьтесь со следующими документами:
Версия 1
Приложение добавляет поле адреса с Яндекс картой и строкой поиска адреса в карточку CRM и робота/действие бизнес-процесса для работы с данными в поле адреса.
После установки приложения в настройках необходимо указать ключ API для работы с картами.
Получить ключ можно в
Кабинете разработчика Яндекса.
Добавить API кнопкой "Подключить API" в правом верхнем углу.
При добавлении нужно выбрать вариант "JavaScript API и HTTP Геокодер".
Появится блок с названием "JavaScript API и HTTP Геокодер". Кликаем на название блока и переходим в его настройки.
Кнопкой "Получить ключ" создаём новый ключ. Потребуется ввести название ключа, чтобы понимать, для чего он создан.
Также в настройках можно указать координаты центра карты по умолчанию.
![](https://app.lbtrm.ru/img/yandexmapfield/settings.png?1719993191522)
В карточке CRM или в настройках CRM создайте новое поле с типом «Адрес с Яндекс картой».
![](https://app.lbtrm.ru/img/yandexmapfield/addfield.png?1719993191522)
Для поиска адреса включите режим редактирования при помощи кнопки «Изменить» в заголовке блока.
В режиме редактирования адрес можно указать кликом на карте, либо найти в поисковой строке.
![](https://app.lbtrm.ru/img/yandexmapfield/field.png?1719993191522)
Для поиска по координатам или просмотра найденных координат переключите поисковую строку в режим «Координаты»
Действие бизнес-процессов и робот
Если на вашем
тарифе Битрикс24 доступны роботы или бизнес-процессы, вы можете использовать робота и действие бизнес-процесса.
Приложение добавляет на портал действие бизнес-процесса и робота для работы с данными, сохранёнными в поле адреса с картой.
В поле сохраняются данные в формате json. При необходимости вы можете получать данные из поля в формате json и обрабатывать их самостоятельно.
Действие бизнес-процесса и робот позволяют получить данные из поля адреса с картой в текстовом виде и использовать далее в автоматизации или бизнес-процесса.
Например, можно создать текстовые поля для сохранения в карточке CRM адреса, сокращённого адреса и координат.
Создать бизнес-процесс, который будет запускаться при создании или изменении элемента.
![](https://app.lbtrm.ru/img/yandexmapfield/bpsettings.png?1719993191522)
Добавить действие «Адрес с Яндекс картой».
![](https://app.lbtrm.ru/img/yandexmapfield/bpaction.png?1719993191522)
В настройках подставить данные из поля с адресом.
![](https://app.lbtrm.ru/img/yandexmapfield/bpactionsettings.png?1719993191522)
![](https://app.lbtrm.ru/img/yandexmapfield/bpactionsettings2.png?1719993191522)
Добавить в бизнес-процесс действие «Изменение документа».
![](https://app.lbtrm.ru/img/yandexmapfield/bpstructure.png?1719993191522)
В настройках действия выбрать текстовые поля, в которые необходимо сохранить адрес и координаты.
Подставить в поля данные, полученные в предыдущем действии. Эти данные доступны в окне вставки значений в разделе «Дополнительные результаты».
![](https://app.lbtrm.ru/img/yandexmapfield/bpactionvalues.png?1719993191522)
Вариант с роботомНапример, на первом этапе обработки лида мы заполняем поле адреса с Яндекс картой.
На второй этап можем добавить роботов, которые при переключении лида в соответствующий статус сохранят адрес и координаты в отдельные текстовые поля.
Добавим робота «Адрес с Яндекс картой»
![](https://app.lbtrm.ru/img/yandexmapfield/robot.png?1719993191522)
В настройках робота укажем поле адреса с Яндекс картой.
Обратите внимание, что при подстановке должно быть только наименование поля должно быть без « > printable».
![](https://app.lbtrm.ru/img/yandexmapfield/robot2.png?1719993191522)
Добавим робота «Изменение документа»
![](https://app.lbtrm.ru/img/yandexmapfield/robot3.png?1719993191522)
В настройках робота добавим поля, в которые нужно сохранить данные, и подставим данные их отработавшего робота «Адрес с Яндекс картой».
Обратите внимание, что необходимо в настройках робота «Изменение документа»
обязательно отметить чекбокс «После предыдущего робота».
![](https://app.lbtrm.ru/img/yandexmapfield/robot4.png?1719993191522)
В результате работы бизнес-процесса или роботов в текстовые поля будут сохранены полный и короткий адреса и координаты.