EN Сьогодні жоден сучасний веб-проект чи мобільний додаток не обходиться без інтеграції геолокаційних сервісів. Серед них Google Maps Platform залишається лідером, пропонуючи потужний набір інструментів для відображення карт, маршрутизації та пошуку місць.
Щоб розпочати роботу з цими інструментами, вам потрібен API-ключ. У цьому посібнику ми крок за кроком покажемо, як його отримати та правильно налаштувати для безпечної та ефективної роботи, відповідно до нових алгоритмів та правил Google.
Крок 1: Створення облікового запису Google Cloud Platform (GCP)
Для використання Google Maps API вам необхідно мати обліковий запис на Google Cloud Platform (GCP). Це уніфікована платформа, яка керує всіма сервісами Google, включаючи карти.
Налаштування платіжного облікового запису (Billing Account)
Це найважливіший крок, який часто ігнорують. Google Maps Platform працює за моделлю Pay-as-you-go (оплата за використання). Однак, Google надає безкоштовний щомісячний ліміт (на момент публікації це близько $200), якого достатньо для більшості невеликих та середніх проектів.
- Чому це обов’язково: Навіть якщо ви не перевищите безкоштовний ліміт, API-ключ не буде активований без прив’язки активного платіжного профілю.
- Дія: Перейдіть до розділу Billing (Оплата) на GCP і створіть новий обліковий запис, додавши свою банківську картку.
Крок 2: Створення нового проекту та активація API
Кожен API-ключ прив’язаний до певного проекту на GCP.
Створення проекту
- У верхньому меню GCP Console виберіть “Select a project” (Обрати проект).
- Натисніть “New Project” (Новий проект).
- Назвіть його відповідно до вашого додатку (наприклад, “My-Awesome-Map-App”).
Активація потрібних API
Google Maps Platform складається з десятків різних API. Щоб ваш ключ працював, ви повинні активувати ті, які плануєте використовувати. Найпопулярніші:
- Maps JavaScript API: Для відображення інтерактивної карти на сайті.
- Places API: Для пошуку місць, автозаповнення адрес.
- Geocoding API: Для перетворення адреси в координати (і навпаки).
- Перейдіть до “APIs & Services” (API та Сервіси) -> “Library” (Бібліотека).
- У пошуку введіть назву потрібного API і натисніть “Enable” (Активувати).
Крок 3: Отримання та обмеження API-ключа (Best Practice)
Цей етап є критичним для безпеки. Необмежений ключ може бути використаний зловмисниками, що призведе до неконтрольованих витрат з вашого платіжного облікового запису.
Генерація ключа
- Перейдіть до “APIs & Services” -> “Credentials” (Облікові дані).
- Натисніть “Create Credentials” (Створити облікові дані) і виберіть “API key” (API-ключ).
- Система згенерує ваш унікальний ключ. Збережіть його негайно, але не робіть його публічним!
Встановлення обмежень (API Restrictions)
Відповідно до нових рекомендацій Google, ви повинні обмежити використання ключа.
Обмеження додатків (Application Restrictions)
Це запобігає використанню вашого ключа на сторонніх сайтах.
- Для веб-сайтів (Websites): Виберіть “HTTP referrers” (HTTP-реферери) і вкажіть домен вашого сайту:
*.yourdomain.com/*(для доступу на всіх субдоменах)yourdomain.com/*(для доступу на основному домені)
- Для мобільних додатків: Виберіть “Android apps” або “iOS apps” і вкажіть SHA-1 сертифікат або Bundle ID вашого додатка відповідно.
Обмеження API (API Restrictions)
Це гарантує, що ключ може викликати лише ті API, які ви активували.
- Виберіть опцію “Restrict key” (Обмежити ключ).
- Поставте галочки лише навпроти тих API, які ви плануєте використовувати (наприклад, Maps JavaScript API, Places API).
Крок 4: Впровадження ключа у ваш проект
Після успішного отримання та обмеження, ви можете вставити ключ у свій код.
Приклад для веб-сайту (JavaScript API)
Для підключення карти на веб-сторінці використовуйте наступний шаблон, замінивши YOUR_API_KEY на ваш ключ:
HTML
<script async defer src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap"> </script>Поради для роботи з Google Maps Platform
- Моніторинг: Регулярно перевіряйте розділ “Billing” та “APIs & Services” для моніторингу використання та витрат. Ви можете встановити бюджети та сповіщення, щоб уникнути несподіваних нарахувань.
- Ротація ключів: Для підвищення безпеки періодично генеруйте нові API-ключі та видаляйте старі.
- Server-Side Ключі: Якщо ви використовуєте API, які викликаються з вашого бекенду (наприклад, Geocoding для масової обробки), завжди використовуйте окремий ключ, обмежений за IP-адресою вашого сервера, а не за HTTP-реферером.
Отримання API-ключа Google Maps Platform — це перший і найважливіший крок до створення потужного географічного рішення. Дотримуючись цих інструкцій, ви забезпечите безпеку та стабільність вашого проекту!
