Інструкція з підключення API Google Maps
API Google Maps використовується для перетворення даних, що містять адреси або назви об’єктів, з текстового вигляду в формат, призначений для відображення об’єкта на карті. Ця можливість використовується в інтеграції Planfix з картами.
Для підключення вам необхідно мати (або зареєструвати новий) обліковий запис Google.
Крок 1. Підключення API Google Maps
- Для початку підключення перейдіть за посиланням.
- Створіть проєкт:
- У головному меню (відкривається натисканням на «бургер» у верхньому лівому куті) оберіть API і служби — Облікові дані:
- Натисніть Створити облікові дані і оберіть пункт Ключ API:
- Скопіюйте отриманий ключ API. Він необхідний для підключення інтеграції з картами в Planfix.
Крок 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 і служби — Бібліотека:
- Вставте в пошук назву потрібного API (скопіюйте її зі списку вище):
- Клікніть на блок знайденого API і натисніть Увімкнути:
- Повторіть цю операцію для кожного API зі списку вище.
Після включення всіх необхідних API можна переходити до включення інтеграції з картами в інтерфейсі Planfix.
Увага: Якщо при спробі ввести адресу в поле типу Місцезнаходження ви бачите інформаційні повідомлення на червоному фоні про вичерпання лімітів API, перевірте прив’язку створеного на Кроці 2 платіжного акаунта до проєкту, створеного на Кроці 1.