Для коректної роботи всіх додатків (сервісів) Google потрібна аутентифікація, яка вимагає отримання унікального API ключа.
До кінця 2016 року ще можна було використовувати такі сервіси як Google Maps без використання API ключа, але тепер всім новим користувачам обов’язково потрібно його отримати.
Якщо ви хочете додати нову Google-карту на свій сайт – вам буде потрібен API-ключ. У сьогоднішній статті ми детально розглянемо практичні кроки, які необхідні для отримання ключа API Google Карт.
Щоб почати використовувати JavaScript API для Гугл Карт, вам потрібно створити проект, в якому вказані ваші платіжні дані для облікового запису, а також для якого включений JavaScript API Google Карт. Нижче більш детально про основні кроки запуску проекту.
На сьогоднішній день Google перевів всі свої сервіси до консолі Google Cloud (її також ще називають Cloud Console). Ця консоль надає доступ до всіх сервісів, набору API та SDK, інших корисних функцій. Якщо у вас є пошта Google, — значить у вас є доступ і до консолі Google Cloud. Наразі головне для повноцінного доступу – ви повинні вказати свої платіжні дані (банківську картку, адресу). З більшістю сервісів ви зможете працювати безкоштовно, але свої платіжні дані ви повинні вказати. Наразі для безкоштовного використання сервісу платформи Google Карт, вам кожного місяця автоматично будуть надаватися бонусні кошти в розмірі 200$ доларів США. Цього повинно вистачити навіть для середнього за розмірами сайту. Орієнтовна вартість використання становить 7$ (доларів США) за 1000 завантажень однієї карти.
До речі, ви можете скористатися калькулятором оплати від Google, щоб розрахувати вартість використання для кожного API або SDK Карт.
Одним із сервісів в консолі Google Cloud є платформа Google Maps, яка містить набір API та SDK, що потрібні вам для розміщення карт Google на вашому сайті. Щоб розпочати роботу з платформою Google Карт, вам потрібно пройти наступні кроки:
Тепер давайте більш детально пройдемося по кожному пункту.
У верхньому меню, поряд із написом Google Cloud Platform, оберіть пункт Вибрати проект (Select a project). Тут ви можете вибрати наявний проект, або ж створити новий, натиснувши кнопку Новий проект (New Project).
На сторінці створення Нового проекту заповніть необхідну інформацію:
Щоб використовувати JavaScript API Карт, у вас повинен бути ключ API. Ключ API – це унікальний ідентифікатор, який використовується для перевірки автентичності запитів, пов’язаних з вашим проектом, для цільового використання і виставлення рахунків.
В одному проекті може бути кілька ключів API, ‘ повинен бути хоча б один. Щоб отримати ключ API, виконайте наступне:
Тепер бажано додати обмеження до використання цього ключа API. В цьому ж діалоговому вікні натисніть кнопку Застосувати обмеження для ключа. Вкажіть, наприклад, домен свого сайту, щоб лише на ньому використовувати створений API ключ.
Щоб використовувати платформу Google Maps, потрібно ввімкнути API чи SDK, які ви плануєте використовувати у своєму проекті. Зауважте, що для деяких інтеграцій потрібно ввімкнути декілька API/SDK. Перейдіть за наступним лінком, та оберіть потрібні сервіси. Клацніть на потрібному сервісі та у вікні, що з’явиться, натисніть Ввімкнути (Enable).
В нових версіях Консолі Гугл включення всіх пов’язаних сервісів відбувається одразу при створенні проекту та виборі необхідного вам функціоналу.
Тепер ви можете додати ключ API до ваших запитів, наприклад, запиту Карт Google на своєму сайті.
Ключ API потрібно включати в кожен JavaScript запит API Google Карт. Приклад використання (з підключення бібліотек мап та маркерів на мапі):
<script async src="https://maps.googleapis.com/maps/api/js?key=ВАШ_API_КЛЮЧ&callback=initMap&libraries=maps,marker"></script>
Замініть ВАШ_API_КЛЮЧ
на свій нещодавно створений ключ API, додайте цей код на свій сайт і тепер ви можете використовувати сервіс Google Maps на повну потужність!
Ця інструкція була оновлена в 2024 році.
Увага! Нижче йде застаріла інформація (інструкція дійсна до 2018 року).
Існує безліч прикладних програмних інтерфейсів (API), які підтримуються сервісом Google Developers. Якщо ви хочете розмістити на своєму сайті Карти від Google, значить вам потрібен ключ Google Maps JavaScript API.
Примітка: Google Maps JavaScript API розділений на два тарифних плани – Стандарт і Преміум. Для більшості сайтів підійде стандартний план, який передбачає безкоштовний доступ до 25 000 завантажень (переглядів) карт в день. Якщо переглядів більше 25000 і менше 100000, тоді вам потрібно буде платити приблизно 0,50 долара за 1000 додаткових переглядів. Якщо ваш сайт генерує трафік більше ніж 100 тис. переглядів карти в день, тоді вам потрібен буде Преміум план.
Давайте почнемо і додамо Google карту на свій сайт.
Першим кроком буде отримання API ключа Google Карт. Для цього вам потрібна буде будь-який обліковий запис Google (він безкоштовний; якщо ви користуєтеся поштою Google GMail – значить він у вас вже є).
Увійдіть в обліковий запис Google і перейдіть на сторінку Google Maps JavaScript API.
Прокрутіть трохи нижче і потім натисніть велику синю кнопку «Отримати ключ» (Get a key).
Це відкриє лайтбокс-форму створення ключа. У випадаючому списку ви можете вибрати з існуючих проектів, або ж створити новий. Давайте створимо новий проект, для цього потрібно у випадаючому списку вибрати + Створити новий проект (+ Create a new project). Введіть зрозумілу для вас назву проекту і натисніть кнопку Далі (Next). Якщо це ваш новий проект, щоб продовжити вам потрібно буде погодитися з умовами обслуговування Google.
Через кілька секунд ви побачите згенерований ключ API Google Карт (це буде набір цифр і букв, що складається з 40 символів). Скопіюйте його та збережіть в доступному місці для подальшого використання.
Наступний крок – поліпшити безпеку вашого нового додатка. Для цього натисніть посилання API Console під полем з вашим API ключем. Відкриється нове вікно, в якому ви можете обмежити використання свого API-ключа тільки на своєму веб-сайті. Це означає, що тільки ви зможете використовувати ключ, а це захистить ключ від використання несанкціонованим користувачем (тим самим ви збережете свій бюджет).
Щоб відображати карти на своєму сайті, виберіть опцію HTTP джерела переходу (веб-сайти).
Нижче відкриється поле для додавання дозволених доменів. Додайте їх в необхідному форматі: *.ДОМЕН.com/*
. Замініть ДОМЕН.com на свій домен.
Зірочки і слеши повинні бути вказані саме у такий спосіб (цим ви дозволите всі сторінки всіх піддоменів вашого сайту). Якщо вам потрібно додати кілька доменів, вкажіть їх в новому рядку нижче, по одному домену за раз.
Після цього натисніть кнопку «Зберегти». І вже через 5 хвилин ви можете використовувати свій новий API-ключ для Google Карти.
Щоб додати Гугл Карту на сайт, ви можете скористатися iframe, або ж JavaScript-кодом. В обох випадках потрібен буде ключ. Більш детальна інформація по додаванню свого сайту на Гугл-карти описано тут.
Розміщення картки Гугл за допомогою JavaScript виглядає приблизно так:
<script async defer src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap" type="text/javascript"></script>
Замініть YOUR_API_KEY
на раніше отриманий ключ і ваша карта повинна запрацювати!
Рекоменуємо продовжити практику: Як додати карту від Google Maps на свій сайт (з маркером і текстом)
Сподіваюсь, що цей короткий урок допоможе вам легко створювати ключ API Google Maps і насолоджуватися Гугл Картою на своєму сайті. Не соромтеся ділитися своїми думками в коментарях нижче.
Вибачення — не означає, що ти не правий, а інша людина має рацію. Це всього…
Атмосферу паперової книги, запах свіжого чорнила і паперу, що трохи залежався, складно замінити гаджетами. Але…
По-перше, щоб не допустити подібних ситуацій, вам заздалегідь потрібно надавати унікальні значення у таблицях. Так…