Адрес с Яндекс.Картой — поле в карточке CRM и роботы

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

Также в настройках можно указать координаты центра карты по умолчанию.


На странице настроек приложения есть подробная инструкция по получению ключей.


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


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


Для поиска по координатам или просмотра найденных координат переключите поисковую строку в режим «Координаты»


Действия бизнес-процессов и роботы
Если на вашем тарифе Битрикс24 доступны роботы или бизнес-процессы, вы можете использовать роботов и действия бизнес-процесса.

Распознавание адреса/координат и заполнение поля
Приложение добавляет на портал действие бизнес-процесса и робота для распознавания адреса по координатам и координат по адресу.
Добавьте в бизнес-процесс действие "Распознавание адреса или координат".

Укажите в настройках действия "Адрес или координаты". Можно указать адрес или координаты, разделённые запятой.
Можно указать код поля с картой, в которое будет записан результат распознавания (если прошло успешно).
Этот параметр можно не использовать в дизайнере бизнес-процессов, т.к. записать значение в поле можно и при помощи активити изменения элемента.



Действие вернёт набор данных:

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

Для отслеживания статуса распознавания адреса добавьте условие.


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



При работе с роботами добавьте робота "Распознавание адреса или координат".
Укажите адрес/координаты или поле, из которого робот возьмёт текстовое значение адреса/координат.
Если необходимо записать результат распознавания в поле с картой, укажите код поля вида "UF_CRM_***********".
При успешном определении адреса результат запишется в поле с указанным кодом.
Так же полученные значения можно будет использовать в других роботах.


Робот вернёт следующий набор полей:

• Адрес полный;
  
• Адрес короткий;
  
• Страна;
  
• Область;
  
• Район;
  
• Город;
  
• Улица;
  
• Дом/Строение;
  
• Координаты;
  
• Ссылка -- короткая ссылка для открытия карты с отмеченной точкой;
  
• Значение для записи в поле с Яндекс-картой -- готовое значение для сохранения распознанного адреса в поле с Яндекс-картой;
  
• Удалось распознать адрес -- возвращает Да или Нет (можно использовать в условии, чтобы сохранять адрес только в случае успешного распознавания).
  

Код поля с картой для записи значения можно узнать в настройках CRM в разделе "Настройки форм и отчётов" -> "Пользовательские поля".
Перейдите в список полей лида, сделки или другой сущности, в которой создано поле с картой.
Откройте настройки этого поля.
Код поля будет виден в адресной строке браузера.


Получение данных из полей "Адрес с Яндекс.Картой".
Так же приложение добавляет на портал действие бизнес-процесса и робота для работы с данными, сохранёнными в поле адреса с картой.
В поле сохраняются данные в формате json. При необходимости вы можете получать данные из поля в формате json и обрабатывать их самостоятельно.
Действие бизнес-процесса и робот позволяют получить данные из поля адреса с картой в текстовом виде и использовать далее в автоматизации или бизнес-процесса.

Например, можно создать текстовые поля для сохранения в карточке CRM адреса, сокращённого адреса и координат.
Создать бизнес-процесс, который будет запускаться при создании или изменении элемента.


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


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




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

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



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

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


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


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

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

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