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

Текущая версия от 13:42, 25 марта 2024

API Google Maps используется для перевода данных, содержащих адреса или названия объектов, из текстового вида в вид, предназначенный для отображения объекта на карте. Эта возможность используется в интеграции ПланФикса с картами.

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

Шаг 1. Подключение API Google Maps

Для старта подключения перейдите по ссылке.
Создайте проект:

В главном меню (открывается по клику на "гамбургер" в верхнем левом углу) выберите API и Сервисы — Учетные данные:

Нажмите Создать учетные данные и выберите пункт Ключ API:

Скопируйте полученный ключ API. Он необходим для подключения интеграции с картами в ПланФиксе.

Шаг 2. Настройка платежного аккаунта

Для работы интеграции необходимо подключить к созданному проекту платежный аккаунт Google. Если у вас нет платежного аккаунта, вы можете создать новый, следуя этой инструкции.

Обратите внимание, в данный момент компания Google не регистрирует новых пользователей Google Cloud в России. В этой связи невозможно выбрать страну «Россия» в настройках платёжного аккаунта.

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

Cозданный платежный аккаунт должен быть привязан к созданному ранее проекту.

Шаг 3. Подключение библиотек

Для корректной работы интеграции вам необходимо подключить следующие API из библиотеки API Google:

Maps JavaScript API;
Geocoding API (для преобразования адреса в координаты);
Geolocation API (для определения местоположения);
Places API (для подсказок при вводе адреса в поле).
Directions API (для построения маршрутов).

Для подключения перейдите в главном меню ("бутерброд") в раздел API и Cервисы — Библиотека:

Вставьте в поиск название нужного API (скопируйте его из списка выше):

Кликните в блок найденного API и нажмите Включить:

Повторите эту операцию для каждого из API из списка выше.

После включения всех необходимых API, можно переходить к включению интеграции с картами в интерфейсе ПланФикса.

Внимание: Если при попытке ввести адрес в поле типа Местоположение вы наблюдаете информационные сообщения на красном фоне по поводу исчерпания лимитов API, проверьте привязку созданного на Шаге 2 платежного аккаунта к созданному на Шаге 1 проекту.

@@ Строка 6: / Строка 6: @@
 == Шаг 1. Подключение API Google Maps ==
 *Для старта подключения перейдите по [https://console.developers.google.com/project/_/apiui/apis/library ссылке].
-*Нажмите '''Создать''':
+*Создайте проект:
-https://p.pfx.so/pf/hT/LQF5c1.jpg
+https://p.pfx.so/pf/2R/Cp4FBR.png
-*Дайте название новому проекту и нажмите '''Создать''':
+*В главном меню (открывается по клику на "гамбургер" в верхнем левом углу) выберите '''API и Сервисы''' — '''Учетные данные''':
-https://p.pfx.so/pf/fx/1wkT6k.jpg
+https://p.pfx.so/pf/RN/nJam4R.png
-*В главном меню (открывается по клику на "гамбургер" в верхнем левом углу) выберите '''API и сервисы / Учетные данные''':
-https://p.pfx.so/pf/IX/KzK7W3.jpg
 *Нажмите '''Создать учетные данные''' и выберите пункт '''Ключ API''':
-https://p.pfx.so/pf/cI/3YZJ6w.jpg
+https://p.pfx.so/pf/Q1/AmPPt9.png
-*Скопируйте созданный ключ API и нажмите '''ЗАКРЫТЬ''':
-https://p.pfx.so/pf/hN/6zHmKA.jpg
-Этот ключ необходим для подключения [[Интеграция с картами | интеграции с картами]] в ПланФиксе.
+*Скопируйте полученный ключ API. Он необходим для подключения [[Интеграция с картами | интеграции с картами]] в ПланФиксе.
 == Шаг 2. Настройка  платежного аккаунта==
-Для работы интеграции необходимо подключить к созданному проекту платежный аккаунт Google. Если у вас нет платежного аккаунта, вы можете создать новый, следуя инструкции ниже.
+Для работы интеграции необходимо подключить к созданному проекту платежный аккаунт Google. Если у вас нет платежного аккаунта, вы можете создать новый, следуя этой [https://cloud.google.com/billing/docs/how-to/create-billing-account инструкции].
-'''Важно:''' На момент написания этой справочной статьи, Google предлагает при подключении бонус в 300USD на 1 год использования любых сервисов Google Cloud Platform. Для этого достаточно создать новый платежный аккаунт и ввести данные кредитной карты. Автоматические платежи с карты не производятся, она служит для идентификации клиента Googlе.
-Процедура создания и подключения платежного аккаунта:
-*В главном меню ("бутерброд") выберите пункт '''Оплата''':
-https://p.pfx.so/pf/0k/83alnv.jpg
-*В появившемся окне нажмите на '''Настроить аккаунты''':
-https://p.pfx.so/pf/0k/TcFBHG.jpg
+<div style="background:#ffbaba;padding:10px;border:1px solid #ff9b9b;">Обратите внимание, в данный момент компания Google не регистрирует новых пользователей Google Cloud в России. В этой связи невозможно выбрать страну «Россия» в настройках платёжного аккаунта.</div>
-*Нажмите '''Добавить платежный аккаунт''':
-https://p.pfx.so/pf/u1/vuQQrH.jpg
+На момент написания этой статьи, Google предлагает при подключении бонус в 300USD на 1 год использования любых сервисов Google Cloud Platform. Для этого достаточно создать новый платежный аккаунт и ввести данные кредитной карты. Автоматические платежи с карты не производятся, она служит для идентификации клиента Googlе.
-*Выберите свою страну и согласитесь с условиями бесплатного тестового периода Google Cloud Platform:
-https://p.pfx.so/pf/y6/9ZoLrl.jpg
-*На следующем экране заполните свои контактные данные и данные платежной карты.
-*После сохранения данных, созданный платежный аккаунт должен быть привязан к созданному ранее проекту.
+Cозданный платежный аккаунт должен быть привязан к созданному ранее проекту.
 == Шаг 3. Подключение библиотек ==
-Для корректной работы интеграции вам необходимо подключить 3 API из библиотеки API Google:
+Для корректной работы интеграции вам необходимо подключить следующие API из библиотеки API Google:
-*Maps JavaScript API
+*Maps JavaScript API;
-*Geocoding API
+*Geocoding API (для преобразования адреса в координаты);
-*Directions API
+*Geolocation API (для определения местоположения);
+*Places API (для подсказок при вводе адреса в поле).
+*Directions API (для построения маршрутов).
-Для подключения перейдите в главном меню ("бутерброд") в раздел '''API и сервисы / Библиотека''':
+Для подключения перейдите в главном меню ("бутерброд") в раздел '''API и Cервисы''' — '''Библиотека''':
+https://p.pfx.so/pf/Tl/MpGmI0.png
-https://p.pfx.so/pf/tt/NfflYb.jpg
 *Вставьте в поиск название нужного API (скопируйте его из списка выше):
-https://p.pfx.so/pf/hB/mNlPVi.jpg
+https://p.pfx.so/pf/7h/RgUa9M.png
 *Кликните в блок найденного API и нажмите '''Включить''':
-https://p.pfx.so/pf/1q/H1PXP3.jpg
+https://p.pfx.so/pf/rj/XyPDwP.png
-*Повторите эту операцию для каждого из 3-х API из списка выше.
+*Повторите эту операцию для каждого из API из списка выше.
-После включения всех 3-х API, можно переходить к включению [[Интеграция с картами | интеграции с картами]] в интерфейсе ПланФикса.
+После включения всех необходимых API, можно переходить к включению [[Интеграция с картами | интеграции с картами]] в интерфейсе ПланФикса.
 '''Внимание:''' Если при попытке ввести адрес в поле типа Местоположение вы наблюдаете информационные сообщения на красном фоне по поводу исчерпания лимитов API, проверьте привязку созданного на Шаге 2 платежного аккаунта к созданному на Шаге 1 проекту.
 == Перейти ==
 *[[Интеграция с картами]]
 *[[Интеграции]]

Навигация

Перейти