Что умеет
Плагин добавляет в редактор блоков элемент «Yandex Map», построенный на JavaScript API Яндекс Карт версии 3. На странице можно разместить несколько независимых карт, а центр, масштаб, наклон, режим карты и светлую или тёмную тему меняют из панели блока с мгновенным предпросмотром.
Что настраивается:
- адаптивные размеры: ширина, высота, минимальная высота, пропорции, широкое и полноэкранное выравнивание;
- маркеры: добавление, дублирование, поиск, сортировка, координаты, подписи, описания, ссылки, цвета, иконки и изображения;
- кластеризация маркеров;
- элементы управления: масштаб, геолокация, полный экран;
- прелоадер: спиннер, прыгающие точки или пульс, либо отключение анимации;
- резервная ссылка при отсутствии JavaScript или ошибке загрузки.
Карты, созданные в версиях 1.0, переносятся автоматически.
Установка и настройка
Получите браузерный ключ JavaScript API v3 в кабинете разработчика Яндекса и ограничьте его по HTTP Referer своим доменом. Затем откройте «Настройки → Yandex Maps», вставьте ключ и добавьте блок на нужную страницу. Ключ виден в коде страницы, поэтому реферер-ограничение обязательно.
Подводные камни
- Ключ и тариф. Без ключа блок покажет ошибку и ссылку-заглушку. Условия и лимиты использования API определяет Яндекс, уточните их заранее.
- Согласие и 152-ФЗ. Подключение к Яндексу передаёт ему технические данные посетителя (IP, user agent, адрес страницы). Укажите это в политике конфиденциальности, а если нужен предварительный выбор посетителя, включите режим загрузки по клику.
- Внешние картинки маркеров. Если указываете URL изображения на стороннем сайте, браузер посетителя обращается к нему отдельно.
- Предпросмотр. В редакторе карту нельзя двигать и масштабировать, это сделано намеренно; на сайте всё работает.
- Содержимое маркеров. Это обычный текст, произвольный HTML и JavaScript в них недоступны.
Кому подойдёт
Сайтам услуг, студиям и блогам на блочном редакторе, которым нужна аккуратная карта с несколькими точками. Для классического подхода посмотрите плагин Яндекс.Карт YaMaps, а для аналитики и сервисов Яндекса — Яндекс Метрику.
