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

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


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


== Крок 1. Підключення API Google Maps ==
== Крок 1. Підключення API Google Maps ==
Рядок 10: Рядок 9:
https://p.pfx.so/pf/2R/Cp4FBR.png
https://p.pfx.so/pf/2R/Cp4FBR.png


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


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


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


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


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


== Крок 2. Налаштування платіжного акаунта ==
== Крок 2. Налаштування платіжного акаунта ==
Для роботи інтеграції необхідно підключити до створеного проєкту платіжний акаунт Google. Якщо у вас немає платіжного акаунта, ви можете створити новий, слідуючи цій [https://cloud.google.com/billing/docs/how-to/create-billing-account інструкції].
Для роботи інтеграції необхідно підключити до створеного проєкту платіжний акаунт 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>
<geoip eq="RU,BY"><div style="background:#ffbaba;padding:10px;border:1px solid #ff9b9b;">Зверніть увагу, наразі компанія Google не реєструє нових користувачів Google Cloud у Росії. У зв'язку з цим неможливо обрати країну «Росія» в налаштуваннях платіжного акаунта.</div></geoip>


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


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


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


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


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


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


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


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


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


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


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

Перейти

Отримано з http://planfix.com/uk/help/index.php?title=Інструкція_з_підключення_API_Google_Maps&oldid=4798