Раздел Yandex Maps API Key в конструкторе сайтов Gridbox для Joomla описывает процесс получения, настройки и подключения персонального ключа API Яндекс Карт (JavaScript API и HTTP Геокодер). Наличие активного ключа API необходимо для корректной отрисовки интерактивных карт Яндекс, поиска объектов по адресу, работы инструментов навигации и отображения кастомных меток компании.
1. Регистрация и получение ключа в Кабинете разработчика Яндекс (Getting Yandex Maps API Key)
Для создания API-ключа вам потребуется учетная запись Яндекс (Яндекс ID) и регистрация в кабинете разработчика:
- Перейдите в Кабинет разработчика Яндекс (Yandex Developer Dashboard) и авторизуйтесь под своим Яндекс ID (главный портал API карт — Yandex Maps API, документация по JS API — Документация JavaScript API Яндекс Карт).
- Нажмите кнопку Подключить API (Connect APIs) или перейдите в раздел Подключение сервисов.
- В каталоге доступных сервисов выберите пакет «JavaScript API и HTTP Геокодер».
- Заполните регистрационную анкету:
- Название проекта / Имя: Укажите название вашего сайта или компании (например, Gridbox Studio Maps);
- Email и номер телефона: Контактные данные для связи и подтверждения профиля;
- Тарифный план: Выберите бесплатный тариф (для открытых общедоступных сайтов с лимитом до 25 000 запросов в сутки) или коммерческий тариф при необходимости работы в закрытых CRM/ERP системах.
- Примите условия пользовательского соглашения и подтвердите создание ключа.
- В списке подключенных сервисов перейдите в созданный проект и скопируйте сгенерированный API-ключ (уникальная GUID-строка вида
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
2. Настройка Yandex Maps API Key в Gridbox (Configuring Key in Gridbox)
После генерации ключа добавьте его в панель управления конструктора:
- В панели управления Gridbox перейдите по пути: Site ➝ Integrations ➝ Yandex Maps API Key (или откройте настройки плагина Yandex Maps непосредственно в визуальном редакторе).
- Вставьте скопированный ключ в поле Yandex Maps API Key.
- Нажмите кнопку Save для сохранения настроек в конфигурации сайта.
3. Возможности и настройка плагина Yandex Maps на странице (Yandex Maps Plugin Options)
При добавлении плагина Яндекс Карт на страницу доступны следующие параметры кастомизации:
- ■ Позиционирование и геопоиск: Ввод точного адреса компании в строку поиска для автоматического определения координат широты и долготы (Latitude / Longitude).
- ■ Кастомные маркеры локаций: Добавление множественных меток с возможностью загрузки собственного графического пина (Custom Marker Icon), настройкой всплывающих подсказок (Tooltip) и информационных балунов (Balloon Content: текст, фото, контакты).
- ■ Элементы управления (Controls): Включение/отключение кнопок зума (+/-), строки поиска объектов, переключателя типов карт (Схема, Спутник, Гибрид), кнопки геолокации пользователя и слоя пробок (Traffic Control).
- ■ Блокировка прокрутки (Scroll Zoom): Отключение масштабирования колесиком мыши для предотвращения случайного залипания скролла страницы при пролистывании сайта на ПК.
4. Сводная таблица параметров Yandex Maps Integration
Полный перечень параметров конфигурации картографического модуля Яндекс Карт в Gridbox:
| Параметр / Поле | Описание и функциональное назначение | Формат / Источник |
|---|---|---|
| Yandex Maps API Key | Секретный токен авторизации JavaScript API и HTTP Геокодера из Кабинета разработчика Яндекс. | GUID-ключ (Строка) |
| Address / Coordinates | Текстовый адрес объекта или точные географические координаты центра карты (Latitude / Longitude). | Текстовая строка / Координаты |
| Map Type | Базовый слой подложки карты: Map (Схема), Satellite (Спутниковые снимки) или Hybrid (Гибрид). | Выпадающий список |
| Zoom Level | Масштаб отображения карты по умолчанию (от 0 — весь мир, до 19 — отдельные здания). | Ползунок / Число (0–19) |
| Markers Manager | Инструмент добавления неограниченного числа меток на карту с индивидуальными иконками и описанием. | Список элементов |
| Controls | Набор переключателей видимости элементов интерфейса: Зум, Поиск, Пробки, Полноэкранный режим. | Переключатели (Yes/No) |
| Save | Сохранение ключа и параметров плагина в базе данных Joomla. | Кнопка действия |
Бесплатная версия API Яндекс Карт разрешает до 25 000 запросов в сутки. Главное юридическое требование Яндекса при бесплатном использовании — карта должна быть общедоступной, а данные геокодирования должны отображаться исключительно на подложке Яндекс Карт с сохранением копирайтов сервиса.
Для сайтов в доменной зоне .ru и аудитории из РФ и стран СНГ всегда отдавай предпочтение Яндекс Картам перед Google Maps: они значительно точнее отображают номера корпусов, строений, внутридворовые проезды и не требуют привязки зарубежных банковских карт для биллинга.