Какие API Яндекс.Карт нужно использовать, чтобы получать и отображать информацию об организации (адрес, контакты, часы работы и т.п.)?

Привет! <br/> Раньше на нашем сайте Яндекс.Карты были подключены через аккаунт сотрудника. Сейчас переключаемся на корпоративный аккаунт. В целом карты работают: точки отображаются, курсор можно перемещать — всё как прежде. Но раньше при клике на иконку организации показывалась информация о ней: <br/>
  • 2 июня 2026 г. 7:00
Ответы на вопрос 1
Коротко — вам нужны две вещи:

1) JavaScript API Яндекс.Карт (ymaps) — для отображения карты, точек и «балунов» (balloon) на фронтенде.  
2) API Яндекс.Справочника / Business API (иногда «Яндекс.Справочник», «Yandex Business» или «Business API») — чтобы программно получать подробную информацию об организации (адрес, телефоны, часы работы, контакты, ссылки и т.п.) и управлять карточками организации. В зависимости от потребностей можно также использовать HTTP Search/Places API Яндекса для поиска POI, но он даёт ограниченный набор полей по сравнению со Справочником.

Рекомендованный рабочий процесс
- На сервере (с защищённым ключом / OAuth-токеном корпоративного аккаунта) вызываете API Яндекс.Справочника, получаете данные организации (по id организации в справочнике).  
- Передаёте эти данные на фронтенд.  
- На странице создаёте ymaps.Placemark (или используете существующую точку) и формируете balloonContentHeader/Body/Footer с полученными данными (адрес, телефоны, часы и т.д.). Так у вас будет полный контроль над содержимым балуна.

Почему у вас перестала показываться информация
- Ранее использовался аккаунт сотрудника, и запросы к API/карточкам выполнялись от его имени. При переключении на корпоративный аккаунт:
  - возможно, не создан/не подключён соответствующий OAuth-токен или API-ключ для нового аккаунта;
  - новый аккаунт не является владельцем/менеджером карточек организаций в Яндекс.Справочнике — и поэтому при запросе к Directory API данные не возвращаются или возвращаются неполные;
  - ключам Яндекс.Карт необходимо правильно настроить referrer/домен и привязку к аккаунту.

Что проверить и сделать (чек-лист)
- Получить API-ключ для Яндекс.Карт (JavaScript API) в кабинете корпоративного аккаунта и использовать его в подключении ymaps. Проверить referrer-ограничения.  
- Получить OAuth-токен / ключ доступа для Яндекс.Справочника от корпоративного аккаунта (или добавить корпоративный аккаунт как владельца/менеджера организаций в Справочнике).  
- Убедиться, что корпоративный аккаунт имеет права на доступ к нужным карточкам (перенести карточки или добавить доступ).  
- На сервере вызывать API Справочника для получения полной информации об организации; не делать секретные токены публичными.  
- На фронтенде формировать балун вручную из полученных данных или использовать данные для заполнения стандартного контента.

Короткий пример алгоритма (псевдо‑код)
- Сервер: запрос в API Справочника → получаем JSON с {name, address, phones, hours, site...}.  
- Фронтенд: ymaps.Placemark([lat,lon], { balloonContentHeader: name, balloonContentBody: address + phones + hours }). Добавить обработчик клика, чтобы показывать балун.

Если хотите — могу:
- посмотреть ваш текущий код подключения карт и подсказать, где конкретно нужно заменить ключ/токен;  
- показать пример запроса к API Справочника и пример формирования балуна в ymaps (реальный код).

Ссылки на документацию: ищите в документации Яндекса разделы «JavaScript API Яндекс.Карт (ymaps)», «API Яндекс.Справочника / Business API» и «Поиск/Places API».
Похожие вопросы