Получение и настройка Google Maps API Key в Gridbox

Раздел Google Maps API Key в конструкторе Gridbox описывает процесс создания, настройки и интеграции персонального API-ключа картографического сервиса Google Maps Platform. Наличие валидного ключа API необходимо для отображения интерактивных карт на сайте, установки кастомных маркеров локаций, стилизации цветовой схемы подложки и работы геопоиска адресов.

1. Создание проекта в Google Cloud Console (Creating a Google Cloud Project)

Для генерации ключа API требуется рабочий проект в облачной консоли Google:

1. Перейдите в консоль управления Google Cloud Console и войдите под вашим Google-аккаунтом (официальный портал платформы — Google Maps Platform, руководство по ключам — Google Maps JavaScript API Docs).
2. В верхней панели рядом с логотипом Google Cloud кликните по выпадающему списку проектов и нажмите New Project (Новый проект).
3. В поле Project Name введите название (например, Gridbox Site Maps) и нажмите кнопку Create.

2. Включение библиотек Google Maps API (Enabling Required APIs)

Для полноценной работы плагинов карт в Gridbox необходимо активировать соответствующие службы в библиотеке API:

1. В боковом меню Google Cloud перейдите в раздел APIs & Services ➝ Library (Библиотека API и сервисов).
2. Через строку поиска найдите и активируйте (кнопка Enable) следующие три библиотеки:
   • Maps JavaScript API: Базовая библиотека для рендеринга и управления интерактивной картой на фронтенде;
   • Geocoding API: Служба преобразования текстовых адресов в географические координаты (широта/долгота) и обратно;
   • Places API: Служба автодополнения и интеллектуального поиска объектов и адресов.

3. Генерация и защита API-ключа (Creating and Restricting API Key)

Чтобы защитить ключ от несанкционированного использования на сторонних сайтах, настройте ограничения доступа:

1. В боковом меню перейдите в подраздел APIs & Services ➝ Credentials (Учетные данные).
2. В верхнем меню нажмите кнопку + Create Credentials ➝ API key — Google мгновенно создаст новый ключ.
3. В появившемся окне нажмите Edit API Key (Редактировать ключ):
   • В блоке Set an application restriction выберите пункт Websites (HTTP referrers);
   • В блоке Website restrictions добавьте разрешенные адреса вашего домена в формате https://*.yourdomain.com/* и https://yourdomain.com/* (для локальной разработки добавьте localhost/*);
   • В блоке API restrictions отметьте пункт Restrict key и выберите из списка: Maps JavaScript API, Geocoding API и Places API.
4. Нажмите кнопку Save и скопируйте итоговый API Key (строка вида AIzaSy...).

4. Привязка платежного аккаунта (Google Cloud Billing)

Google Maps Platform требует обязательной привязки платежного профиля к проекту:

• ■ Обязательное условие: Перейдите в раздел Google Cloud Billing Console и привяжите банковскую карту к вашему проекту.
• ■ Бесплатный лимит: Google ежемесячно предоставляет каждому аккаунту бесплатный кредит в размере $200, чего с избытком хватает на десятки тысяч просмотров карт в месяц для большинства коммерческих сайтов без реальных денежных списаний.

5. Настройка Google Maps API Key в Gridbox (Configuring Key in Gridbox)

После получения ключа добавьте его в настройки конструктора:

1. В панели управления Gridbox перейдите по пути: Site ➝ Integrations ➝ Google Maps API Key (или откройте настройки плагина Google Maps на любой странице).
2. Вставьте скопированный ключ в поле Google Maps API Key.
3. Нажмите кнопку Save — интерактивная карта на всех страницах сайта мгновенно начнет загружаться в штатном режиме.

6. Сводная таблица параметров Google Maps Integration

Полный перечень параметров конфигурации картографического модуля Google Maps в Gridbox: