Інструкція з підключення API Google Maps: відмінності між версіями
(Створена сторінка: API Google Maps використовується для перекладу даних, які містять адреси або назви об'єктів, з текстового вигляду в вид, призначений для відображення об'єкта на карті. Ця можливість використовується в інтеграції Planfix з картами. Для пі...) |
Немає опису редагування |
||
| Рядок 1: | Рядок 1: | ||
API Google Maps використовується для | API Google Maps використовується для перетворення даних, що містять адреси або назви об'єктів, з текстового вигляду у вигляд, призначений для відображення об'єкта на карті. Ця можливість використовується в [[Інтеграція з картами| інтеграції Planfix з картами]]. | ||
Для підключення вам | Для підключення вам необхідно мати (або зареєструвати новий) обліковий запис Google. | ||
== Крок 1. Підключення API Google Maps == | == Крок 1. Підключення API Google Maps == | ||
*Для | *Для початку підключення перейдіть за [https://console.developers.google.com/project/_/apiui/apis/library посиланням]. | ||
* | *Створіть проєкт: | ||
https://p.pfx.so/pf/ | https://p.pfx.so/pf/2R/Cp4FBR.png | ||
* | *У головному меню (відкривається при кліку на «гамбургер» у верхньому лівому куті) виберіть '''API та Сервіси''' — '''Облікові дані''': | ||
https://p.pfx.so/pf/ | https://p.pfx.so/pf/RN/nJam4R.png | ||
* | *Натисніть '''Створити облікові дані''' і виберіть пункт '''API-ключ''': | ||
https://p.pfx.so/pf/ | https://p.pfx.so/pf/Q1/AmPPt9.png | ||
* | *Скопіюйте отриманий API-ключ. Він необхідний для підключення [[Інтеграція з картами| інтеграції з картами]] в Planfix. | ||
https:// | == Крок 2. Налаштування платіжного акаунта == | ||
Для роботи інтеграції необхідно підключити до створеного проєкту платіжний акаунт Google. Якщо у вас немає платіжного акаунта, ви можете створити новий, слідуючи цій [https://cloud.google.com/billing/docs/how-to/create-billing-account інструкції]. | |||
<div style="background:#ffbaba;padding:10px;border:1px solid #ff9b9b;">Зверніть увагу, наразі компанія Google не реєструє нових користувачів Google Cloud у Росії. У зв'язку з цим неможливо обрати країну «Россия» в налаштуваннях платіжного акаунта.</div> | |||
На момент написання цієї статті, Google пропонує при підключенні бонус у 300 USD на 1 рік використання будь-яких сервісів Google Cloud Platform. Для цього достатньо створити новий платіжний акаунт і ввести дані кредитної картки. Автоматичні платежі з картки не здійснюються, вона служить для ідентифікації клієнта Google. | |||
Створений платіжний акаунт повинен бути прив'язаний до створеного раніше проєкту. | |||
== Крок 3. Підключення бібліотек == | == Крок 3. Підключення бібліотек == | ||
Для коректної роботи інтеграції вам необхідно підключити наступні API з бібліотеки API Google: | Для коректної роботи інтеграції вам необхідно підключити наступні API з бібліотеки API Google: | ||
*Maps JavaScript API; | * Maps JavaScript API; | ||
*Geocoding API (для перетворення адреси в координати); | * Geocoding API (для перетворення адреси в координати); | ||
*Geolocation API (для визначення | * Geolocation API (для визначення місцеположення); | ||
*Places API (для підказок | * Places API (для підказок під час введення адреси в поле); | ||
*Directions API (для побудови маршрутів). | * Directions API (для побудови маршрутів). | ||
Для підключення перейдіть у головному меню («бутерброд») в розділ '''API та Сервіси''' — '''Бібліотека''': | |||
https://p.pfx.so/pf/Tl/MpGmI0.png | |||
*Вставте в пошук назву потрібного API (скопіюйте її зі списку вище): | |||
https://p.pfx.so/pf/7h/RgUa9M.png | |||
*Клікніть у блоці знайденого API і натисніть '''Увімкнути''': | |||
https://p.pfx.so/pf/rj/XyPDwP.png | |||
*Повторіть цю операцію для кожного API зі списку вище. | |||
Після ввімкнення всіх необхідних API можна переходити до ввімкнення [[Інтеграція з картами| інтеграції з картами]] в інтерфейсі Planfix. | |||
'''Увага:''' Якщо при спробі ввести адресу в поле типу Місцеположення ви бачите інформаційні повідомлення на червоному фоні про вичерпання лімітів API, перевірте прив'язку створеного на Кроці 2 платіжного акаунта до проєкту, створеного на Кроці 1. | |||
== Перейти == | == Перейти == | ||
*[[Інтеграція з картами]] | *[[Інтеграція з картами]] | ||
*[[Інтеграції]] | *[[Інтеграції]] | ||
Поточна версія на 12:28, 23 листопада 2025
API Google Maps використовується для перетворення даних, що містять адреси або назви об'єктів, з текстового вигляду у вигляд, призначений для відображення об'єкта на карті. Ця можливість використовується в інтеграції Planfix з картами.
Для підключення вам необхідно мати (або зареєструвати новий) обліковий запис Google.
Крок 1. Підключення API Google Maps
- Для початку підключення перейдіть за посиланням.
- Створіть проєкт:
- У головному меню (відкривається при кліку на «гамбургер» у верхньому лівому куті) виберіть API та Сервіси — Облікові дані:
- Натисніть Створити облікові дані і виберіть пункт API-ключ:
- Скопіюйте отриманий API-ключ. Він необхідний для підключення інтеграції з картами в Planfix.
Крок 2. Налаштування платіжного акаунта
Для роботи інтеграції необхідно підключити до створеного проєкту платіжний акаунт Google. Якщо у вас немає платіжного акаунта, ви можете створити новий, слідуючи цій інструкції.
На момент написання цієї статті, Google пропонує при підключенні бонус у 300 USD на 1 рік використання будь-яких сервісів Google Cloud Platform. Для цього достатньо створити новий платіжний акаунт і ввести дані кредитної картки. Автоматичні платежі з картки не здійснюються, вона служить для ідентифікації клієнта Google.
Створений платіжний акаунт повинен бути прив'язаний до створеного раніше проєкту.
Крок 3. Підключення бібліотек
Для коректної роботи інтеграції вам необхідно підключити наступні API з бібліотеки API Google:
- Maps JavaScript API;
- Geocoding API (для перетворення адреси в координати);
- Geolocation API (для визначення місцеположення);
- Places API (для підказок під час введення адреси в поле);
- Directions API (для побудови маршрутів).
Для підключення перейдіть у головному меню («бутерброд») в розділ API та Сервіси — Бібліотека:
- Вставте в пошук назву потрібного API (скопіюйте її зі списку вище):
- Клікніть у блоці знайденого API і натисніть Увімкнути:
- Повторіть цю операцію для кожного API зі списку вище.
Після ввімкнення всіх необхідних API можна переходити до ввімкнення інтеграції з картами в інтерфейсі Planfix.
Увага: Якщо при спробі ввести адресу в поле типу Місцеположення ви бачите інформаційні повідомлення на червоному фоні про вичерпання лімітів API, перевірте прив'язку створеного на Кроці 2 платіжного акаунта до проєкту, створеного на Кроці 1.