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

Материал из Planfix
Перейти к: навигация, поиск
Нет описания правки
 
(не показано 20 промежуточных версий 4 участников)
Строка 4: Строка 4:




== Подключение API Google Maps ==
== Шаг 1. Подключение API Google Maps ==
*Для старта подключения перейдите по [https://console.developers.google.com/project/_/apiui/apis/library ссылке].
*Для старта подключения перейдите по [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''':
*Нажмите '''Создать учетные данные''' и выберите пункт '''Ключ API''':


https://p.pfx.so/pf/cI/3YZJ6w.jpg
https://p.pfx.so/pf/Q1/AmPPt9.png




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


https://p.pfx.so/pf/hN/6zHmKA.jpg
== Шаг 2. Настройка  платежного аккаунта==
Для работы интеграции необходимо подключить к созданному проекту платежный аккаунт 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>


Этот ключ необходим для подключения [[Интеграция с картами | интеграции с картами]] в ПланФиксе.


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


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 (скопируйте его из списка выше):
*Вставьте в поиск название нужного API (скопируйте его из списка выше):


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




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


https://p.pfx.so/pf/1q/H1PXP3.jpg
https://p.pfx.so/pf/rj/XyPDwP.png
 


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


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




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


После включения всех 3-х API, можно переходить к включению [[Интеграция с картами | интеграции с картами]] в интерфейсе ПланФикса.


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


== Перейти ==
== Перейти ==
*[[Интеграция с картами]]
*[[Интеграция с картами]]
*[[Интеграции]]
*[[Интеграции]]

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

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

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


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

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

Cp4FBR.png


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

nJam4R.png


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

AmPPt9.png


Шаг 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ервисыБиблиотека:

MpGmI0.png


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

RgUa9M.png


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

XyPDwP.png


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


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


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

Перейти