Раздел OpenWeatherMap API Key в конструкторе сайтов Gridbox для Joomla описывает пошаговый процесс генерации, подключения и активации API-ключа метеорологического сервиса OpenWeatherMap. Наличие ключа API необходимо для корректной работы плагина Weather (Погода), позволяющего выводить текущие погодные условия, динамические иконки осадков, влажность, силу ветра и прогноз погоды на ближайшие дни в любой точке мира.
1. Регистрация и получение API-ключа OpenWeatherMap (Getting OpenWeatherMap API Key)
Для получения персонального ключа аутентификации (App ID) вам потребуется бесплатная учетная запись разработчика:
- Перейдите на страницу регистрации аккаунта OpenWeatherMap Sign Up (главный портал метеорологической платформы — OpenWeatherMap.org, официальная документация API — OpenWeatherMap API Docs).
- Заполните форму регистрации (Username, Email, Пароль), подтвердите согласие с правилами сервиса и завершите регистрацию.
- Проверьте входящую почту и подтвердите регистрацию кликом по ссылке активации в письме от OpenWeather.
- Войдите в личный кабинет и перейдите в раздел управления ключами по прямой ссылке: OpenWeatherMap: API keys.
- В блоке Create key введите понятное имя ключа (например, Gridbox Weather Widget) и нажмите кнопку Generate (или используйте ключ Default, созданный системой автоматически).
- Скопируйте сгенерированный 32-значный буквенно-цифровой Key (App ID).
2. Настройка OpenWeatherMap в панели Gridbox (Configuring OpenWeatherMap in Gridbox)
После копирования ключа сохраните и активируйте его в глобальных настройках интеграций Gridbox:
- В панели управления Gridbox наведите курсор на иконку Extensions (Расширения) в левой панели ➝ выберите пункт Integrations (Интеграции) или перейдите по пути Site ➝ Integrations.
- В списке доступных сервисов кликните по пункту OpenWeatherMap.
- В появившемся модальном окне вставьте ваш скопированный ключ в поле App Id (API Key).
- Нажмите кнопку Save (Сохранить).
- Убедитесь, что статус интеграции переведен в активное состояние, нажав на иконку публикации — Publish Item.
3. Размещение и настройка плагина Weather в макете (Configuring Weather Plugin)
После активации интеграции вы можете добавить погодный информер в любое место страницы:
- ■ Добавление плагина: В визуальном редакторе Gridbox нажмите кнопку добавления плагина (+) ➝ перейдите в категорию Content / Basic ➝ выберите плагин Weather и перетащите его в нужную секцию, шапку (Header) или подвал (Footer) сайта.
- ■ Локация (City / Location): В настройках плагина укажите целевой город на английском языке или в международном формате (например,
London, UK,Moscow, RU,Ljubljana, SI,Novosibirsk, RU). - ■ Единицы измерения (Units): Выберите систему отображения температуры — Metric (°C, метры в секунду) или Imperial (°F, мили в час).
- ■ Отображаемые параметры: Включите или отключите показ прогноза на 3–5 дней (Forecast), влажности воздуха (Humidity), силы и направления ветра (Wind), атмосферного давления и текстового описания облачности.
- ■ Стилизация: Настройте цвет шрифтов, размер иконок погоды, прозрачность фона и отступы под общий дизайн макета.
4. Сводная таблица параметров OpenWeatherMap Integration
Полный перечень параметров конфигурации сервиса погоды OpenWeatherMap в Gridbox:
| Параметр / Поле | Описание и функциональное назначение | Формат / Источник |
|---|---|---|
| App Id (API Key) | Секретный 32-значный ключ авторизации, сгенерированный в личном кабинете OpenWeatherMap. | 32-значный хэш-токен |
| Publish Item | Статус глобальной публикации и доступности сервиса для плагина Weather. | Иконка публикации (Active/Inactive) |
| City / Location | Название города или координаты локации для запроса текущих метеорологических данных. | Текстовая строка (City, Country Code) |
| Units | Система единиц измерения температуры и метеоданных: Metric (Цельсий) или Imperial (Фаренгейт). | Переключатель (Metric / Imperial) |
| Save | Сохранение параметров интеграции и ключа API в конфигурации Joomla. | Кнопка действия |
Бесплатный тарифный план OpenWeatherMap предоставляет 60 вызовов API в минуту и до 1 000 000 бесплатных запросов в месяц. Gridbox автоматически кэширует метеоданные на стороне сервера, что исключает превышение лимитов даже на высоконагруженных порталах.
У OpenWeatherMap есть техническая особенность: вновь созданный API-ключ становится активным не мгновенно, а в течение 10–30 минут после генерации в личном кабинете (на серверах OpenWeather идет репликация кэша). Если сразу после вставки ключа плагин Weather возвращает ошибку 401 Unauthorized (Invalid API Key), не меняй настройки — просто подожди 15–20 минут, и виджет автоматически начнет отдавать корректные данные.