Інструкція з підключення 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/fx/1wkT6k.jpg
 
 
*У головному меню (відкривається по кліку на "гамбургер" в верхньому лівому куті) виберіть '''API та сервіси / Облікові дані''':
 
https://p.pfx.so/pf/IX/KzK7W3.jpg
 
 
*Натисніть '''Створити облікові дані''' і виберіть пункт '''Ключ API''':


https://p.pfx.so/pf/cI/3YZJ6w.jpg
https://p.pfx.so/pf/2R/Cp4FBR.png


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


*Скопіюйте створений ключ API і натисніть '''ЗАКРИТИ''':
https://p.pfx.so/pf/RN/nJam4R.png


https://p.pfx.so/pf/hN/6zHmKA.jpg
*Натисніть '''Створити облікові дані''' і виберіть пункт '''API‑ключ''':


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


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


== Крок 2. Налаштування платіжного акаунта ==
Для роботи інтеграції необхідно підключити до створеного проєкту платіжний акаунт Google. Якщо у вас немає платіжного акаунта, ви можете створити новий, дотримуючись цієї [https://cloud.google.com/billing/docs/how-to/create-billing-account інструкції].


== Крок 2. Налаштування  платіжного облікового запису==
<geoip eq="RU,BY"><div style="background:#ffbaba;padding:10px;border:1px solid #ff9b9b;">Зверніть увагу, наразі компанія Google не реєструє нових користувачів Google Cloud у Росії. У зв'язку з цим неможливо обрати країну «Росія» в налаштуваннях платіжного акаунта.</div></geoip>
Для роботи інтеграції необхідно підключити до створеного проекту платіжний обліковий запис Google. Якщо у вас немає платіжного облікового запису, ви можете створити новий, слідуючи інструкції нижче.


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


'''Важливо:''' На момент написання цієї довідкової статті, Google пропонує при підключенні бонус в 300USD на 1 рік використання будь-яких сервісів Google Cloud Platform. Для цього достатньо створити новий платіжний обліковий запис і ввести дані кредитної картки. Автоматичні платежі з картки не проводяться, вона служить для ідентифікації клієнта Google.
Створений платіжний акаунт має бути прив'язаний до створеного на Кроці 1 проєкту.
 
 
Процедура створення і підключення платіжного облікового запису:
*У головному меню ("бутерброд") виберіть пункт '''Оплата''':
 
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/hB/mNlPVi.jpg
 
 
*Клікніть у блок знайденого API і натисніть '''Увімкнути''':


https://p.pfx.so/pf/1q/H1PXP3.jpg
Для підключення перейдіть у головному меню («бутерброд») в розділ '''API і Служби''' — '''Бібліотека''':


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


*Повторіть цю операцію для кожного з API зі списку вище.
*Вставте у пошук назву потрібного API (скопіюйте її зі списку вище):


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


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


Після увімкнення всіх необхідних API, можна переходити до включення [[Інтеграція з картами| інтеграції з картами]] в інтерфейсі Planfix.
https://p.pfx.so/pf/rj/XyPDwP.png


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


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


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


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

Поточна версія на 01:24, 16 грудня 2025

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

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

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

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

Cp4FBR.png

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

nJam4R.png

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

AmPPt9.png

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

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


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

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

Крок 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 проєкту.

Перейти