Перегляд вихідного коду сторінки Інструкція з підключення API Google Maps

API Google Maps використовується для перетворення даних, що містять адреси або назви об'єктів, з текстового вигляду у вигляд, призначений для відображення об'єкта на карті. Ця можливість використовується в [[Інтеграція з картами| інтеграції Planfix з картами]].

Для підключення вам необхідно мати (або зареєструвати новий) обліковий запис Google.


== Крок 1. Підключення API Google Maps ==
*Для початку підключення перейдіть за [https://console.developers.google.com/project/_/apiui/apis/library посиланням].
*Створіть проєкт:

https://p.pfx.so/pf/2R/Cp4FBR.png


*У головному меню (відкривається при кліку на «гамбургер» у верхньому лівому куті) виберіть '''API та Сервіси''' — '''Облікові дані''':

https://p.pfx.so/pf/RN/nJam4R.png


*Натисніть '''Створити облікові дані''' і виберіть пункт '''API-ключ''':

https://p.pfx.so/pf/Q1/AmPPt9.png


*Скопіюйте отриманий API-ключ. Він необхідний для підключення [[Інтеграція з картами| інтеграції з картами]] в Planfix.

== Крок 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. Підключення бібліотек ==
Для коректної роботи інтеграції вам необхідно підключити наступні API з бібліотеки API Google:
* Maps JavaScript API;
* Geocoding API (для перетворення адреси в координати);
* Geolocation API (для визначення місцеположення);
* Places 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.

== Перейти ==
*[[Інтеграція з картами]]
*[[Інтеграції]]