Інструкція з підключення 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 проєкту.