Обмеження додатків:
- Виберіть Android apps (Додатки для Android).
- Заповніть поля Package name (Назва пакета) та SHA-1 certificate fingerprint (Цифровий відбиток сертифіката SHA-1).
- Значення повинні відповідати потрібному формату. Приклад:
com.example.android.mapexample
BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
- Натисніть Restrict key (Застосувати обмеження для ключа).
- У списку, що розкривається Select APIs (Виберіть API) натисніть Maps SDK for Android (Maps SDK для Android). Якщо Maps SDK для Android там немає, його потрібно увімкнути.
Cloud SDK
Список наявних ключів.
gcloud services api-keys list --project no">PROJECT"
Зняття обмежень із існуючого ключа.
gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \ --clear-restrictions
Налаштування нових обмежень для наявного ключа.
gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \ --api-target="maps-android-backend.googleapis.com" --allowed-application no">SHA1_FINGERPRINT,package_name=ANDROID_PACKAGE_NAME"
Прочитайте статті про Google Cloud SDK, встановлення Cloud SDK та наступні команди:
Що далі
Якщо не вказано інше, контент на цій сторінці надається за ліцензією Creative Commons "З вказівкою авторства 4.0", а приклади коду – за ліцензією Apache 2.0. Докладніше про це написано у правилах сайту. Java – це зареєстрований товарний знак корпорації Oracle та її афілійованих осіб.
Останнє оновлення: 2024-07-03 UTC.
Використання ключів API
Продукти платформи Google Карт захищені від несанкціонованого використання, оскільки приймають лише ті виклики API, які містять дійсні облікові дані для автентифікації. Ці облікові дані надаються у вигляді ключа API – унікального рядка з літер та цифр, що пов'язує платіжний обліковий запис Google з проектом та з певним API або SDK.
У цьому посібнику показано, як створити та використовувати ключ API платформи Google Карт, а також обмежити його використання.
Підготовка
Щоб розпочати роботу, вам потрібно буде створити проект із платіжним обліковим записом та увімкненим Maps JavaScript API. Інструкції можна знайти у статті Налаштування в Google Cloud Console.
Як створити ключі API
Ключ API є унікальним ідентифікатором, за допомогою якого виконується автентифікація запитів, пов'язаних з вашим проектом. Він потрібний для обліку використання API та оплати. З вашим проектом має бути пов'язаний хоча б один ключ API.
Щоб створити його, виконайте такі дії:
Cloud Console
- Відкрийте сторінку Google Maps Platform > Credentials (Платформа Google Карт > Облікові дані). Перейти до установок облікових даних
- На сторінці Credentials (Облікові дані) натисніть Create credentials > API key (Створити облікові дані > Ключ API).
З'явиться діалогове вікно з створеним ключем API.
- Натисніть Close (Закрити).
Новий ключ API можна знайти в розділі API keys (Ключі API) на сторінці Credentials (Облікові дані).
Не забудьте настроїти обмеження для ключа API, перш ніж використовувати його в робочому середовищі.
Cloud SDK
gcloud alpha services api-keys create \ --project "PROJECT" \ --display-name "DISPLAY_NAME"
Прочитайте статті про Google Cloud SDK, встановлення Cloud SDK та наступні команди:
Як обмежити використання ключів API
Ми наполегливо рекомендуємо обмежувати використання ключів лише тими API, які необхідні для роботи вашої програми. Це захистить вашу програму від небажаних запитів. Детальну інформацію ви знайдете в Рекомендаціях щодо безпеки доступу до API.
Обмеження, які ви задаєте спеціально для додатків у Cloud Console, перевизначають налаштування у розділі API restrictions (Припустимі API)Тому ми радимо дотримуватися рекомендацій і створювати окремі ключі API для кожної програми та кожної платформи, на якій ця програма буде доступна.
Щоб встановити обмеження для ключа API, виконайте такі дії:
Cloud Console
- Відкрийте сторінку Google Maps Platform > Credentials (Платформа Google Карт > Облікові дані). Перейти на сторінку Credentials (Облікові дані)
- Виберіть потрібний ключ API.
- У розділі Key restrictions (Обмеження для ключа) встановіть такі обмеження:
- Обмеження додатків:
- Щоб приймати запити від сайтів, які входять до списку, виберіть HTTP referrers (web sites) (HTTP-джерела переходу (веб-сайти)) у списку Application restrictions (Припустимий тип додатків).
- Вкажіть один або кілька сайтів – джерел переходу. При необхідності використовуйте підстановочні знаки, щоб авторизувати всі субдомени (наприклад, https://*.google.com) дозволяє використовувати всі сторінки, що закінчуються на .google.com . увага, що якщо ви вкажете домен www.domain.com, то він буде працювати як варіант з підстановним знаком www.domain.com/* та підтримувати всі шляхи нижчого рівня у складі цього імені хоста. Підтримуються тільки схеми реферера https:// і http:// . //path/to/* . Увімкнувши сайт, обов'язково відстежте використання API і перевірте, чи воно відповідає вашим очікуванням.Підтримуються такі протоколи: about:// , app:// , applewebdata:// , asset:// , chrome:// , content:// , file:// , ftp:// , ionic:// , local :// , ms-appx:// , ms-appx-web:// , ms-local-stream:// , prism:// , qrc:// , res:// , saphtmlp:// .
- Натисніть Restrict key (Застосувати обмеження для ключа).
- У списку, що розкривається Select APIs (Виберіть API) натисніть Maps JavaScript API. Якщо Maps JavaScript API немає у списку, його потрібно увімкнути.
- Якщо у вашому проекті використовується бібліотека Places Library, виберіть Places API. Також необхідно увімкнути та вибрати API, зазначені в цьому списку, для всіх інших сервісів, які потрібні для роботи JavaScript API (Directions Service, Distance Matrix Service, Elevation Service та/або Geocoding Service).
Cloud SDK
Список наявних ключів.
gcloud services api-keys list --project no">PROJECT"
Зняття обмежень із існуючого ключа.
gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \ --clear-restrictions
Налаштування нових обмежень для наявного ключа.
gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \ --api-target="maps-backend.googleapis.com" --allowed-referrers no">referer"
Прочитайте статті про Google Cloud SDK, встановлення Cloud SDK та наступні команди:
Як додати ключ API у запит
Кожен запит до JavaScript API Maps повинен містити ключ API. Вкажіть свій ключ API замість YOUR_API_KEY у наступному прикладі:
Якщо не вказано інше, контент на цій сторінці надається за ліцензією Creative Commons "З вказівкою авторства 4.0", а приклади коду – за ліцензією Apache 2.0. Докладніше про це написано у правилах сайту. Java – це зареєстрований товарний знак корпорації Oracle та її афілійованих осіб.
Останнє оновлення: 2024-07-31 UTC.
Google Maps API: з чого почати
Що таке Google Maps API та для чого він використовується?
Google Maps Platform (далі GMP) – це набір API та SDK, які дозволяють розробникам вбудовувати Карти Google та витягувати дані з мобільних додатків та сторінок веб-сайтів. оптимізації маршрутів в реальному часі і карт, що налаштовуються.
Google Maps API пропонує своїм клієнтам три продукти для покращення роботи на основі розташування: Maps (Карти), Routes (Маршрути) та Places (Місця). API, які дозволяють розробникам створювати нові інтерактивні карти з більш актуальними даними:
Maps (Карти)
- Динамічні карти Додайте інтерактивні картки для мобільних та веб-платформ у свої програми та налаштовуйте свої карти.
- Статичні карти Додайте зображення статичної картки на свій сайт із мінімальним кодом.
- Зображення вулиць.
- Динамічний перегляд вулиць Вбудуйте зображення реального світу із оглядом 360°.
- Підвищення Отримайте дані висоти для одного або кількох місць без використання JavaScript.
- Вбудовані карти Додайте інтерактивну карту або панораму Перегляду вулиць на свій сайт за допомогою простого HTTP-запиту.
Routes (Маршрути)
- Напрями Створюйте маршрути для різних видів транспорту, використовуючи інформацію про пробки в режимі реального часу.
- Матриця відстаней.Розрахуйте відстань та час у дорозі для кількох пунктів відправлення та призначення.
- Дорога. Визначте маршрути руху транспортного засобу за координатами.
Places (Місця)
- API та Places SDK. Інтегруйте опис місць, пошук Google та функції автозаповнення до своїх програм.
- Геокодування. Перетворюйте координати на адреси та навпаки.
- Геолокація. Отримуйте приблизне розташування вашого пристрою на основі даних від вишок стільникового зв'язку та сайтів Wi-Fi.
- Часові пояси. Визначте часові пояси для наборів координат.
- Поточне місце. Знаходьте місце в поточному місці розташування пристрою, наприклад місцеву компанію, пам'ятку або географічне розташування.
- Пошук місць. Показуйте список місць, таких як місцеві підприємства та визначні місця, на основі розташування користувача, текстового запиту, номера телефону або рядка пошуку.
- Розміщення фотографій. Отримуйте доступ до мільйонів фотографій, що зберігаються в базі даних Google Places.
- Автозаповнення. Допоможіть користувачам знайти саме те місце, яке вони шукають, автоматично пропонуючи компанії та пам'ятки в міру їхнього пошуку.
- Перевірка адрес (буде доступна незабаром): Виправляйте та підтверджуйте адреси, виявляючи відсутні або неправильні компоненти та стандартизуючи їх.
Платформа Google Maps та ключ API: як його отримати
Створіть проект Google Сloud Platfrom
- Перш ніж використовувати GMP, ви повинні створити проект Google Cloud Platform (далі GCP) та підключити платіжний обліковий запис. Слід зазначити, що нові користувачі GCP отримують кредит у розмірі 300 доларів США на пробний період, який можна використовувати для будь-якого продукту GCP, включаючи GMP.
- Коли ви налаштовуєте платіжний обліковий запис, саме час створити проект у консолі адміністратора Google. Зверніть увагу, що з цього моменту ім'я вашого проекту не можна буде змінити.
Створюючи свій перший проект, ви вибираєте платіжний обліковий запис для цього проекту. Вам не потрібно буде використовувати інші параметри вибору, якщо у вас є лише один платіжний обліковий запис.
3. Якщо у вас є організація, яку ви бажаєте пов'язати з цим проектом, натисніть на неї. Якщо ні, просто залиште це поле у такому вигляді та натисніть «Створити» (Create).
Увімкнути API або SDK
Відтепер ви стаєте користувачем GMP. На подальших етапах вам слід включити свої API та SDK (комплект для розробки програмного забезпечення), які дозволять вам використовувати інструменти Maps, Places або Routes у ваших програмах та на сайтах. Ви можете зробити це прямо зі свого проекту Google Cloud Platform, виконавши чотири прості кроки.
- Перейдіть до консолі Google Cloud Platform. Не забудьте перевірити свій проект на відповідність тому, що ви хочете використовувати зараз.
- Потім перейдіть до Меню, знайдіть пункт Карти Google і виберіть API.
Тут ви побачите всі API та SDK, доступні для включення вашого проекту.
- Щоб увімкнути API, виберіть той, який потрібно включити, і натисніть на нього. На сторінці, що відкрилася, ви побачите всю інформацію про API, включаючи ціни та документацію. Потім ви повинні натиснути "Увімкнути" (Enable).
- Після увімкнення API, ви можете його використовувати. Тут ви можете побачити деякі додаткові API, які ви не включили, і переглянути всі показники та дані вашого увімкненого API, включаючи трафік, помилки і т.д.
Тепер, коли ви увімкнули свій API, наступним кроком буде створення ключа API.
Згенерувати ключ API
Ключ API - це унікальний ідентифікатор, який дозволяє Google визначати, хто запитує доступ до платформи, і перевіряти, чи є у них на це дозвіл. Ключ API також повідомляє GCP, у якому проекті потрібно оплачуватись. ключ API, пов'язаний із вашим проектом.
- Щоб створити API-ключ, ви повинні перейти в консоль Google Cloud Platform, а також не забудьте перевірити, чи є обраний проект тим, який ви хочете використовувати, як ви це зробили при включенні вашого API.
- Виберіть меню, знайдіть "API та сервіси" (APIs and Services), а потім виберіть "Облікові дані" (Credentials).
3. Потім ви повинні натиснути кнопку “Створити облікові дані” (Create credentials button) і вибрати ключ API з меню, що розкривається. Як тільки ви це зробите, ви побачите спливаюче вікно з вашим новим ключем API. Credentials.
Після створення ключа API, ви можете обмежити його використання для запобігання шкідливого використання у випадку крадіжки вашого ключа. дізнатися більше про ціни або використання API Google Maps ви можете зв'язатися з нашою командою.
Експерти Cloudfresh по GMP допоможуть вам розпочати роботу зі створення сучасних інтерактивних карток для ваших клієнтів і нададуть вам всю інформацію про функції GMP, а також нададуть підтримку у створенні та використанні Google Maps API для бізнесу та інших продуктів GCP.
Cloudfresh – це унікальний експертний центр для Google Cloud, Zendesk та Asana.
- Налаштування;
- Розробка;
- Інтеграція;
- Підготовка;
- Ліцензія;
- Підтримка.
Наші фахівці допоможуть вам оптимізувати вашу ІТ-інфраструктуру, розробити інтеграцію для кращої сумісності систем, а також допоможуть створити нові структури та процеси для ваших команд, а наш центр підтримки надасть вам найкращий клієнтський досвід!
