Интеграция с Яндекс Картами

Материал из Planfix

Интеграция с Яндекс Картами позволяет использовать картографические возможности прямо в системе: отображать объекты на карте, автоматически определять координаты по адресу, подсказывать адреса при вводе и строить маршруты.

Что понадобится

Для работы интеграции нужны API-ключи Яндекса — они выдаются в Кабинете разработчика Яндекса. Всего используется четыре ключа, каждый отвечает за свою часть функциональности:

Ключ За что отвечает
Yandex JS API Key Отображение интерактивной карты
Yandex Geocoder API Key Определение координат по адресу и адреса по координатам
Yandex Geosuggest API Key Подсказки адресов и организаций при вводе
Yandex Route API Key Построение маршрутов и расчет расстояний

Шаг 1. Получите API-ключи в Кабинете разработчика Яндекса

  • Перейдите в Кабинет разработчика Яндекса и авторизуйтесь.
  • Нажмите "Подключить API" и выберите нужный сервис.
  • Заполните анкету — после этого ключ появится в разделе "Ключи API".
  • Повторите для каждого сервиса из списка ниже.

Какие сервисы выбрать и где посмотреть подробности:

Важно:

  • В некоторых тарифах JavaScript API и HTTP Геокодер подключаются одним пакетом — в этом случае у вас будет один общий ключ. Вставьте его и в поле "Yandex JS API Key", и в поле "Yandex Geocoder API Key".
  • Ключ активируется не мгновенно — в документации Яндекса указано, что активация ключей занимает около 15 минут, на практике этот процесс иногда может занимать значительно больше времени, вплоть до нескольких часов. Если карта не заработала сразу, подождите немного.
  • Есть лимиты на количество запросов в сутки. Актуальные условия и тарифы — на странице API Яндекс Карт и в справке Кабинета разработчика.
  • Если для ключа настроено ограничение по HTTP Referer (доменам), добавьте в список разрешенных адрес вашего аккаунта ПланФикса.

Шаг 2. Включите интеграцию в ПланФиксе

  • Перейдите в раздел Управление аккаунтом — Интеграции — Карты.
  • Нажмите кнопку "Включить интеграцию".
  • В открывшемся окне в поле "Источник карты" выберите "Yandex Maps".
  • Вставьте полученные ключи в соответствующие поля:
    • Yandex JS API Key
    • Yandex Geocoder API Key
    • Yandex Geosuggest API Key
    • Yandex Route API Key
  • Сохраните настройки.

Если что-то пошло не так

  • Карта не отображается — проверьте, что ключ уже активирован (в документации Яндекса указано, что активация ключей занимает около 15 минут, на практике этот процесс иногда может занимать значительно больше времени, вплоть до нескольких часов) и вставлен без лишних пробелов.
  • Ошибка 403 при работе с адресами или маршрутами — как правило, это означает, что ключ не подключен к нужному сервису или сработало ограничение по доменам. Проверьте настройки ключа в Кабинете разработчика.
  • Перестали работать подсказки или маршруты — возможно, исчерпан суточный лимит. Статистика запросов по каждому ключу доступна в Кабинете разработчика.

Перейти