После установки приложения в настройках необходимо указать ключ API для работы с картами.
Получить ключ можно в
Кабинете разработчика Яндекса.
Добавить API кнопкой "Подключить API" в правом верхнем углу.
При добавлении нужно выбрать вариант "JavaScript API и HTTP Геокодер".
Появится блок с названием "JavaScript API и HTTP Геокодер". Кликаем на название блока и переходим в его настройки.
Кнопкой "Получить ключ" создаём новый ключ. Потребуется ввести название ключа, чтобы понимать, для чего он создан.
Также в настройках можно указать координаты центра карты по умолчанию.

В карточке CRM или в настройках CRM создайте новое поле с типом «Адрес с Яндекс картой».

Для поиска адреса включите режим редактирования при помощи кнопки «Изменить» в заголовке блока.
В режиме редактирования адрес можно указать кликом на карте, либо найти в поисковой строке.

Для поиска по координатам или просмотра найденных координат переключите поисковую строку в режим «Координаты»
Действия бизнес-процессов и роботы
Если на вашем
тарифе Битрикс24 доступны роботы или бизнес-процессы, вы можете использовать роботов и действия бизнес-процесса.
Распознавание адреса/координат и заполнение поляПриложение добавляет на портал действие бизнес-процесса и робота для распознавания адреса по координатам и координат по адресу.
Добавьте в бизнес-процесс действие "Распознавание адреса или координат".
Укажите в настройках действия "Адрес или координаты". Можно указать адрес или координаты, разделённые запятой.
Можно указать код поля с картой, в которое будет записан результат распознавания (если прошло успешно).
Этот параметр можно не использовать в дизайнере бизнес-процессов, т.к. записать значение в поле можно и при помощи активити изменения элемента.

Действие вернёт набор данных:
- Полный адрес;
- Сокращённый адрес;
- Координаты объекта;
- Значение для записи в поле с картой (это значение можно при помощи действия изменения элемента записать в поле "Адрес с Яндекс.Картой")
- Ссылку;
- Удалось распознать адрес -- возвращает Да или Нет. Можно скорректировать ход бизнес-процесса в зависимости от того, удалось ли определить адрес.
Для отслеживания статуса распознавания адреса добавьте условие.

При успешном определении адреса используйте действие изменения элемента для записи данных в поле с картой.

При работе с роботами добавьте робота "Распознавание адреса или координат".
Укажите адрес/координаты или поле, из которого робот возьмёт текстовое значение адреса/координат.
Если необходимо записать результат распознавания в поле с картой, укажите код поля вида "UF_CRM_***********".
При успешном определении адреса результат запишется в поле с указанным кодом.
Так же полученные значения можно будет использовать в других роботах.
Получение данных из полей "Адрес с Яндекс.Картой".Так же приложение добавляет на портал действие бизнес-процесса и робота для работы с данными, сохранёнными в поле адреса с картой.
В поле сохраняются данные в формате json. При необходимости вы можете получать данные из поля в формате json и обрабатывать их самостоятельно.
Действие бизнес-процесса и робот позволяют получить данные из поля адреса с картой в текстовом виде и использовать далее в автоматизации или бизнес-процесса.
Например, можно создать текстовые поля для сохранения в карточке CRM адреса, сокращённого адреса и координат.
Создать бизнес-процесс, который будет запускаться при создании или изменении элемента.

Добавить действие «Адрес с Яндекс картой».

В настройках подставить данные из поля с адресом.


Добавить в бизнес-процесс действие «Изменение документа».

В настройках действия выбрать текстовые поля, в которые необходимо сохранить адрес и координаты.
Подставить в поля данные, полученные в предыдущем действии. Эти данные доступны в окне вставки значений в разделе «Дополнительные результаты».

Вариант с роботомНапример, на первом этапе обработки лида мы заполняем поле адреса с Яндекс картой.
На второй этап можем добавить роботов, которые при переключении лида в соответствующий статус сохранят адрес и координаты в отдельные текстовые поля.
Добавим робота «Адрес с Яндекс картой»

В настройках робота укажем поле адреса с Яндекс картой.
Обратите внимание, что при подстановке должно быть только наименование поля должно быть без « > printable».

Добавим робота «Изменение документа»

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

В результате работы бизнес-процесса или роботов в текстовые поля будут сохранены полный и короткий адреса и координаты.
