Інструкція з підключення API Google Maps
API Google Maps використовується для перекладу даних, які містять адреси або назви об'єктів, з текстового вигляду в вид, призначений для відображення об'єкта на карті. Ця можливість використовується в інтеграції Planfix з картами.
Для підключення вам потрібно мати (або зареєструвати нову) обліковий запис Google.
Крок 1. Підключення API Google Maps
- Для старту підключення перейдіть за посиланням.
- Натисніть Створити:
- Дайте назву новому проекту і натисніть Створити:
- У головному меню (відкривається по кліку на "гамбургер" в верхньому лівому куті) виберіть API та сервіси / Облікові дані:
- Натисніть Створити облікові дані і виберіть пункт Ключ API:
- Скопіюйте створений ключ API і натисніть ЗАКРИТИ:
Цей ключ необхідний для підключення інтеграції з картами в Planfix.
Крок 2. Налаштування платіжного облікового запису
Для роботи інтеграції необхідно підключити до створеного проекту платіжний обліковий запис Google. Якщо у вас немає платіжного облікового запису, ви можете створити новий, слідуючи інструкції нижче.
Важливо: На момент написання цієї довідкової статті, Google пропонує при підключенні бонус в 300USD на 1 рік використання будь-яких сервісів Google Cloud Platform. Для цього достатньо створити новий платіжний обліковий запис і ввести дані кредитної картки. Автоматичні платежі з картки не проводяться, вона служить для ідентифікації клієнта Google.
Процедура створення і підключення платіжного облікового запису:
- У головному меню ("бутерброд") виберіть пункт Оплата:
- У вікні, що відкрилося, натисніть на Налаштувати облікові записи:
- Натисніть Додати платіжний обліковий запис:
- Виберіть свою країну і погодьтеся з умовами безкоштовного тестового періоду Google Cloud Platform:
- На наступному екрані заповніть свої контактні дані і дані платіжної картки.
- Після збереження даних, створений платіжний обліковий запис повинен бути прив'язаний до створеного раніше проекту.
Крок 3. Підключення бібліотек
Для коректної роботи інтеграції вам необхідно підключити наступні API з бібліотеки API Google:
- Maps JavaScript API;
- Geocoding API (для перетворення адреси в координати);
- Geolocation API (для визначення місцезнаходження);
- Places API (для підказок при введенні адреси в поле).
- Directions API (для побудови маршрутів).
Для підключення перейдіть у головному меню ("бутерброд") в розділ API та сервіси / Бібліотека:
- Вставте в пошук назву потрібного API (скопіюйте його зі списку вище):
- Клікніть у блок знайденого API і натисніть Увімкнути:
- Повторіть цю операцію для кожного з API зі списку вище.
Після увімкнення всіх необхідних API, можна переходити до включення інтеграції з картами в інтерфейсі Planfix.
Увага: Якщо при спробі ввести адресу в поле типу Місцезнаходження ви спостерігаєте інформаційні повідомлення на червоному фоні про вичерпання лімітів API, перевірте прив'язку створеного на Кроці 2 платіжного облікового запису до створеного на Кроці 1 проекту.