API-ключ Google Maps

Шаг 1 — Откройте Google Cloud Console

Откройте консоль Google Cloud и войдите под аккаунтом Google (подойдёт обычный аккаунт Gmail).

Открыть Google Cloud Console

💡 Совет: используйте отдельный рабочий аккаунт, а не личный, чтобы всё оставалось аккуратно.

Шаг 2 — Создайте проект

«Проект» — это контейнер, в котором будут жить ваш ключ и настройки.

1. Сверху, рядом с логотипом «Google Cloud», нажмите на выпадающий список проекта.
2. Нажмите Новый проект.
3. Дайте узнаваемое название, например RoyLead Maps, и нажмите Создать.
4. Убедитесь, что сверху выбран только что созданный проект.

Шаг 3 — Включите биллинг

Google требует привязанную карту даже для использования бесплатного тарифа. Без активного биллинга появится ошибка или водяной знак «For development purposes only».

1. В левом меню (☰) перейдите в Биллинг.
2. Нажмите Привязать платёжный аккаунт.
3. Введите свои данные и карту, затем подтвердите.

🔒 Добавление карты не означает, что с вас спишут деньги. Google списывает средства, только если вы превысите месячный бесплатный лимит, что крайне маловероятно для лендинга. Ниже я покажу, как настроить оповещение о бюджете.

Шаг 4 — Включите нужные API

Нужно включить сервисы Google, которые использует автозаполнение адреса.

1. В меню (☰) перейдите в API и сервисы → Библиотека.
2. Найдите и включите по одному эти три API (для каждого: откройте и нажмите Включить):

• Maps JavaScript API — карта и поле с подсказками.
• Places API — сами подсказки адреса.
• Geocoding API — восстанавливает почтовый индекс, когда Google его не даёт (см. блок ниже).

ℹ️ Включение API ничего не стоит: платите только за реальное использование. Включите все три, чтобы избежать ошибок вроде «This API is not enabled».

📮 Зачем нужен Geocoding API. Google прикрепляет индекс к номеру дома: если выбрать подсказку только с улицей, индекса не будет — и форма не отправится, если индекс обязателен. Когда его нет, мы восстанавливаем его по координатам выбранного адреса — это один дополнительный запрос, и только в таком случае. Без этого API ничего не ломается: клиент вводит индекс вручную.

ℹ️ Places API (New) не нужен: наша форма использует классическое автозаполнение. Если вы уже его включили, неважно, оставите ли вы его включённым или отключите.

Шаг 5 — Создайте API-ключ

1. В меню (☰) перейдите в API и сервисы → Учётные данные.
2. Нажмите + Создать учётные данные → Ключ API.
3. Google сгенерирует ключ: длинную строку вида AIzaSyB3xK...d9F2qZ.
4. Скопируйте его (вставите в RoyLead на Шаге 7). Пока не закрывайте: сначала ограничим его.

⚠️ Никогда не публикуйте этот ключ в публичных чатах, скриншотах или репозиториях. Даже после ограничения относитесь к нему как к паролю.

Шаг 6 — Ограничьте ключ (важно для безопасности)

Ключ попадает в код лендинга, поэтому виден всем, кто смотрит исходный код. Чтобы никто не мог скопировать и использовать его за ваш счёт, его нужно ограничить. Откройте ключ со страницы Учётные данные (иконка карандаша) и настройте два ограничения.

6a — HTTP-источники (referrers) (с каких сайтов можно использовать)

1. В разделе Ограничения приложения выберите HTTP-источники (веб-сайты).
2. Добавьте URL домена, на котором будете использовать ключ (обе строки):

https://вашдомен.com/*
https://*.вашдомен.com/*

Замените вашдомен.com на свой домен. Несколько доменов? Лучше создать отдельный ключ для каждого домена (в RoyLead ключ привязан к домену).

6b — Ограничения API

1. В разделе Ограничения API выберите Ограничить ключ.
2. Отметьте только: Maps JavaScript API, Places API, Geocoding API.
3. Сохранить.

⚠️ Применение ограничений может занять до 5 минут. Если сразу после этого видите ошибку, подождите пару минут и попробуйте снова.

Шаг 7 — Вставьте ключ в RoyLead

1. Откройте настройки домена в RoyLead.
2. Выберите домен, на котором хотите включить автозаполнение.
3. Вставьте ключ в поле Google Maps API Key и сохраните.

Перейти в Domains ↗

Шаг 8 — Проверьте, что всё работает

1. Откройте лендинг, опубликованный на этом домене.
2. В форме начните вводить адрес (например, «Улица Рима…»).
3. Должны появиться подсказки Google: выберите одну — поле заполнится. ✅

Если подсказки не появляются, смотрите раздел «Решение проблем».

Сколько это стоит

Google предоставляет ежемесячный бесплатный лимит использования для API Maps/Places. При типичных объёмах лендинга вы почти всегда остаётесь в бесплатных пределах и платите 0 €. Карта служит лишь гарантией и покрывает возможное превышение лимита.

Для спокойствия настройте оповещение о бюджете:

1. Меню (☰) → Биллинг → Бюджеты и оповещения.
2. Создать бюджет, низкий порог (например, 5 €), оповещение по email.

💳 Places Autocomplete делает запрос на каждое нажатие клавиши: 1 лид = горстка запросов, а не один. И всё же, чтобы реально начать платить, понадобилось бы несколько тысяч заполненных форм в месяц.

Решение проблем

💡 Для отладки: откройте лендинг, нажмите F12 → вкладка Console. Ошибки Google Maps там отображаются с точным названием: найдите его в таблице выше.

Лучшие практики

• 🔑 Один ключ на домен (в RoyLead ключ привязан к домену): если один утечёт, заблокируете только его.
• 🔒 Всегда ограничивайте ключ (Шаг 6): неограниченный ключ — это ключ, которым кто-то воспользуется за ваш счёт.
• 🚨 Держите оповещение о бюджете включённым.