Скилл 2ГИС в Aizor: как подключить и искать организации, адреса и координаты

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

Скилл 2ГИС отдаёт эту работу агенту: он ищет по рубрике и радиусу и сам собирает данные. Дальше разберём, как его подключить, на примере такого магазина.

Что агент умеет с картой 2ГИС?

Команда Aizor описывает скилл так: поиск организаций и филиалов, адреса, телефоны, графики работы и рейтинги, прямое и обратное геокодирование через API 2ГИС.

Агент ищет по названию, рубрике, адресу или координатам. Прямое геокодирование превращает адрес в координаты, обратное находит адрес по точке на карте. Скилл пригодится тем, кто собирает базу точек для рассылки, проверяет адреса клиентов или подбирает конкурентов рядом с будущей точкой. Про приложение в целом написано на странице «Что такое Aizor».

Одно уточнение к описанию Aizor. Телефоны так просто не придут. По документации 2ГИС контакты организации открываются только с дополнительным разрешением у ключа, и выдают его по запросу за отдельную плату. Так что без него агент найдёт организацию, адрес, график и рейтинг, но телефон может не получить.

Что нужно подготовить?

• Регистрация в личном кабинете «Менеджер Платформы» на platform.2gis.ru.
• Демо-ключ или платная подписка на нужные сервисы: Places API для поиска организаций, Geocoder API для адресов и координат.
• Для телефонов и ИНН организаций – дополнительное согласование с отделом продаж 2ГИС.
• Приложение Aizor для macOS или Windows и скилл 2ГИС из каталога.

Где взять ключ и сколько это стоит?

Для первой пробы хватит демо-ключа, подписка нужна позже, когда агент пойдёт в постоянную работу.

1. Зарегистрируйтесь в личном кабинете «Менеджер Платформы».
2. На вкладке «Главная» нажмите «Создать демо-ключ», введите название ключа и нажмите «Создать».
3. Демо-ключ дают один раз на месяц. Запросов на нём по 1 000 на Places API и на Geocoder API, и это на весь месяц, а не в день.
4. Для постоянной работы оформите подписку. Затем откройте вкладку «Ключи API», нажмите «Создать API-ключ» и введите название. Если подписка оформлена впервые, первый ключ создастся сам.
5. Нажмите «Сохранить и скачать ключ». Один ключ работает со всеми сервисами, которые входят в подписку.

Демо-ключ можно перевести в рабочий режим после оформления подписки: действие «Сделать боевым» в строке ключа. Обратно в демо-режим ключ не вернуть.

Подписка оплачивается пакетами на платёжный месяц. Самые маленькие пакеты на октябрь 2026 года:

Сервис	Пакет	Цена в месяц
Places API	10 000 запросов	от 6 700 ₽
Geocoder API	10 000 запросов	от 4 700 ₽

Платите вы только за успешные запросы, с ответом 200 или 204, а подписка на год на 10% дешевле. Скорость ограничена: 600 запросов в минуту на сервис. Актуальные цифры смотрите на странице «Стоимость» в кабинете.

Затем установите скилл 2ГИС из каталога Aizor и вставьте ключ в его настройки.

Как проверить, что всё работает?

Все четыре просьбы только читают данные карты, так что пробовать можно смело.

• «Найди кофейни рядом с адресом Москва, Каретный ряд, 3» (поиск, только чтение).
• «Какие координаты у адреса Москва, Университетский проспект, 9?»
• «Какой адрес у точки 55.770784, 37.609256?» (обратное геокодирование).
• «Покажи график работы и рейтинг этой организации».

Как это выглядит в работе?

Как собрать список точек для обзвона или рассылки?

Вы просите найти все магазины и кафе вокруг будущей точки и собрать название, адрес и график в таблицу. Агент делает запросы по рубрике и радиусу. Если нужны телефоны, сначала проверьте, что у ключа есть доступ к контактам. Готовую таблицу можно отправить в Google Таблицы.

Как проверить список адресов?

Когда магазин заработает, появятся заявки на доставку с адресами клиентов. Агент находит координаты каждого и помечает адреса, которые 2ГИС не нашёл. Для разбора адресов и реквизитов компаний есть ещё скилл DaData.

Как найти конкурентов рядом с будущей точкой?

Перед открытием магазина вы просите найти организации нужной рубрики в радиусе от адреса и отсортировать по рейтингу. API сортирует результаты по рейтингу и по расстоянию, так что сразу видно, у кого из соседей рейтинг выше и кто ближе к вашей точке.

Как следить за филиалами?

Если точек станет несколько, агент по расписанию проходит по вашим филиалам, читает рейтинг и график и присылает сводку. Тексты отзывов через эти поля не приходят, о них написано в статье про отзывы на картах.

Что делать, если что-то не вышло?

Чаще всего дело в опечатке в запросе или в правах ключа. Вот что бывает:

Что видите	Причина	Что делать
Ответ 404, «Results not found»	Опечатка в имени параметра (например, Q вместо q) или объекта нет в 2ГИС.	Проверьте запрос и найдите объект вручную на карте 2gis.ru.
Ответ 400, «Param is invalid»	Передано несуществующее значение параметра.	Сверьте значения со справочником API 2ГИС.
Слишком широкая или неточная выдача	В запросе нет точки поиска, радиуса или типа объекта.	Уточните район, радиус и тип объекта.
Нет телефонов в ответе	У ключа нет разрешения на контакты.	Обратитесь в отдел продаж 2ГИС.
Ключ перестал работать	Закончился месяц демо-ключа или лимит запросов, ключ заблокирован, подписка ждёт оплаты.	Посмотрите статус ключа на вкладке «Ключи API». Статусы: «Активен», «Неактивен», «Ждёт подписку».

Как не потерять контроль над ключом?

Скилл только читает данные карты, но ключ стоит денег и должен оставаться у вас:

• Заведите отдельный ключ под агента и дайте ему только нужные сервисы.
• В карточке ключа задайте лимиты запросов по сервисам и, если у вас постоянный IP, ограничение по IP-адресам или подсетям.
• Не пересылайте ключ в чатах и письмах, храните его только в настройках скилла.
• Если ключ утёк, заблокируйте его: значок в строке ключа, пункт «Заблокировать». Заблокированный ключ вернуть нельзя, создайте новый.
• Следите за расходом запросов: на платной подписке каждый успешный запрос входит в пакет.

Теперь список соседей и конкурентов будущего магазина собирается одной просьбой, а не вечером за картой.

Инструкция написана по официальной документации 2ГИС (docs.2gis.com), состояние на октябрь 2026 года. Интерфейс кабинета и условия могут измениться. Автор Aizorlab участвует в партнёрской программе Aizor.