Інструкція з підключення API Google Maps: відмінності між версіями

Матеріал з Planfix
Перейти до: навігація, пошук
(Створена сторінка: API Google Maps використовується для перекладу даних, які містять адреси або назви об'єктів, з текстового вигляду в вид, призначений для відображення об'єкта на карті. Ця можливість використовується в інтеграції Planfix з картами. Для пі...)
 
Немає опису редагування
 
Рядок 1: Рядок 1:
API Google Maps використовується для перекладу даних, які містять адреси або назви об'єктів, з текстового вигляду в вид, призначений для відображення об'єкта на карті. Ця можливість використовується в [[Інтеграція з картами| інтеграції Planfix з картами]].
API Google Maps використовується для перетворення даних, що містять адреси або назви об'єктів, з текстового вигляду у вигляд, призначений для відображення об'єкта на карті. Ця можливість використовується в [[Інтеграція з картами| інтеграції Planfix з картами]].


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




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


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




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


https://p.pfx.so/pf/fx/1wkT6k.jpg
https://p.pfx.so/pf/RN/nJam4R.png




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


https://p.pfx.so/pf/IX/KzK7W3.jpg
https://p.pfx.so/pf/Q1/AmPPt9.png




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


https://p.pfx.so/pf/cI/3YZJ6w.jpg
== Крок 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>


*Скопіюйте створений ключ API і натисніть '''ЗАКРИТИ''':


https://p.pfx.so/pf/hN/6zHmKA.jpg
На момент написання цієї статті, Google пропонує при підключенні бонус у 300 USD на 1 рік використання будь-яких сервісів Google Cloud Platform. Для цього достатньо створити новий платіжний акаунт і ввести дані кредитної картки. Автоматичні платежі з картки не здійснюються, вона служить для ідентифікації клієнта Google.
 
 
Цей ключ необхідний для підключення [[Інтеграція з картами| інтеграції з картами]] в Planfix.
 
 
== Крок 2. Налаштування  платіжного облікового запису==
Для роботи інтеграції необхідно підключити до створеного проекту платіжний обліковий запис Google. Якщо у вас немає платіжного облікового запису, ви можете створити новий, слідуючи інструкції нижче.
 
 
'''Важливо:''' На момент написання цієї довідкової статті, Google пропонує при підключенні бонус в 300USD на 1 рік використання будь-яких сервісів Google Cloud Platform. Для цього достатньо створити новий платіжний обліковий запис і ввести дані кредитної картки. Автоматичні платежі з картки не проводяться, вона служить для ідентифікації клієнта Google.
 
 
Процедура створення і підключення платіжного облікового запису:
*У головному меню ("бутерброд") виберіть пункт '''Оплата''':
 
https://p.pfx.so/pf/0k/83alnv.jpg
 
 
*У вікні, що відкрилося, натисніть на '''Налаштувати облікові записи''':
 
https://p.pfx.so/pf/0k/TcFBHG.jpg
 
 
*Натисніть '''Додати платіжний обліковий запис''':
 
https://p.pfx.so/pf/u1/vuQQrH.jpg
 
 
*Виберіть свою країну і погодьтеся з умовами безкоштовного тестового періоду Google Cloud Platform:
<div style="background:#ffbaba;padding:10px;border:1px solid #ff9b9b;">Зверніть увагу, на даний момент компанія Google не реєструє нових користувачів Google Cloud в Росії. В цьому зв'язку неможливо вибрати країну «Росія» в налаштуваннях платіжного облікового запису.</div>
 
 
https://p.pfx.so/pf/y6/9ZoLrl.jpg
 
 
*На наступному екрані заповніть свої контактні дані і дані платіжної картки.
*Після збереження даних, створений платіжний обліковий запис повинен бути прив'язаний до створеного раніше проекту.  


Створений платіжний акаунт повинен бути прив'язаний до створеного раніше проєкту.


== Крок 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/tt/NfflYb.jpg
Для підключення перейдіть у головному меню («бутерброд») в розділ '''API та Сервіси''' — '''Бібліотека''':


https://p.pfx.so/pf/Tl/MpGmI0.png


*Вставте в пошук назву потрібного API (скопіюйте його зі списку вище):


https://p.pfx.so/pf/hB/mNlPVi.jpg
*Вставте в пошук назву потрібного API (скопіюйте її зі списку вище):


https://p.pfx.so/pf/7h/RgUa9M.png


*Клікніть у блок знайденого API і натисніть '''Увімкнути''':


https://p.pfx.so/pf/1q/H1PXP3.jpg
*Клікніть у блоці знайденого API і натисніть '''Увімкнути''':


https://p.pfx.so/pf/rj/XyPDwP.png


*Повторіть цю операцію для кожного з API зі списку вище.


*Повторіть цю операцію для кожного API зі списку вище.




Після увімкнення всіх необхідних API, можна переходити до включення [[Інтеграція з картами| інтеграції з картами]] в інтерфейсі Planfix.


Після ввімкнення всіх необхідних API можна переходити до ввімкнення [[Інтеграція з картами| інтеграції з картами]] в інтерфейсі Planfix.


'''Увага:''' Якщо при спробі ввести адресу в поле типу Місцезнаходження ви спостерігаєте інформаційні повідомлення на червоному фоні про вичерпання лімітів API, перевірте прив'язку створеного на Кроці 2 платіжного облікового запису до створеного на Кроці 1 проекту.


'''Увага:''' Якщо при спробі ввести адресу в поле типу Місцеположення ви бачите інформаційні повідомлення на червоному фоні про вичерпання лімітів API, перевірте прив'язку створеного на Кроці 2 платіжного акаунта до проєкту, створеного на Кроці 1.


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

Поточна версія на 12:28, 23 листопада 2025

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

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


Крок 1. Підключення API Google Maps

  • Для початку підключення перейдіть за посиланням.
  • Створіть проєкт:

Cp4FBR.png


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

nJam4R.png


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

AmPPt9.png


Крок 2. Налаштування платіжного акаунта

Для роботи інтеграції необхідно підключити до створеного проєкту платіжний акаунт Google. Якщо у вас немає платіжного акаунта, ви можете створити новий, слідуючи цій інструкції.

Зверніть увагу, наразі компанія Google не реєструє нових користувачів Google Cloud у Росії. У зв'язку з цим неможливо обрати країну «Россия» в налаштуваннях платіжного акаунта.


На момент написання цієї статті, Google пропонує при підключенні бонус у 300 USD на 1 рік використання будь-яких сервісів Google Cloud Platform. Для цього достатньо створити новий платіжний акаунт і ввести дані кредитної картки. Автоматичні платежі з картки не здійснюються, вона служить для ідентифікації клієнта Google.

Створений платіжний акаунт повинен бути прив'язаний до створеного раніше проєкту.

Крок 3. Підключення бібліотек

Для коректної роботи інтеграції вам необхідно підключити наступні API з бібліотеки API Google:

  • Maps JavaScript API;
  • Geocoding API (для перетворення адреси в координати);
  • Geolocation API (для визначення місцеположення);
  • Places API (для підказок під час введення адреси в поле);
  • Directions API (для побудови маршрутів).


Для підключення перейдіть у головному меню («бутерброд») в розділ API та СервісиБібліотека:

MpGmI0.png


  • Вставте в пошук назву потрібного API (скопіюйте її зі списку вище):

RgUa9M.png


  • Клікніть у блоці знайденого API і натисніть Увімкнути:

XyPDwP.png


  • Повторіть цю операцію для кожного API зі списку вище.


Після ввімкнення всіх необхідних API можна переходити до ввімкнення інтеграції з картами в інтерфейсі Planfix.


Увага: Якщо при спробі ввести адресу в поле типу Місцеположення ви бачите інформаційні повідомлення на червоному фоні про вичерпання лімітів API, перевірте прив'язку створеного на Кроці 2 платіжного акаунта до проєкту, створеного на Кроці 1.

Перейти