Работа с Менеджером Платформы

Отличия версий On-Cloud и On-Premise

Менеджер Платформы доступен как On-Cloud (подробнее см. в документации личного кабинета), так и On-Premise. Доступные функции различаются в зависимости от инсталляции:

	On-Cloud	On-Premise
Мониторинг состояния сервисов	✗	✓
Загрузка пользовательских стилей карты	✗ (Можно указать стиль в настройках карты)	✓
Тестирование сервисов в песочнице	✓	✓
Создание ключей доступа	✓	✗ (Только в веб-интерфейсе управления API-ключами)
Управление ключами доступа	✓	✗ (Только в веб-интерфейсе управления API-ключами)
Просмотр статистики по ключам доступа	✓	✓
Управление пользователями и ролями	✓ (См. инструкцию Управление пользователями)	✓

Начало работы

Чтобы начать работу с Менеджером Платформы, выполните следующие шаги:

1. Убедитесь, что сервис Менеджер Платформы установлен и работает корректно. Подробнее см. в инструкции по установке Менеджера Платформы.
2. Перейдите по ссылке вида https://platform.example.com, которую вы получили в результате установки сервиса.

Интерфейс Менеджера Платформы содержит три вкладки:

• Мониторинг

  

  Здесь вы можете:

  • Просматривать список сервисов, установленных внутри комплекса On-Premise.
  • Проверять статусы их работы.

• Стили карты

  

  Здесь вы можете:

  • Загружать пользовательские стили карты для использования в закрытом контуре.
  • Обновлять стили карты и переключаться между ними. Вы можете как использовать новые стили, так и загружать обновлённые версии одного стиля.
  • Просматривать список загруженных стилей и информацию о них: ID стиля, версии и тип карты, для которой создан стиль.
  • Удалять загруженные стили.

• Песочницы

  

  Здесь вы можете протестировать работу ключевых API (для работы с песочницами устанавливать сервисы не требуется):

  • MapGL JS API: трёхмерную интерактивную карту на движке WebGL.
  • Geocoder API: API поиска для определения координат объекта по адресу (прямой геокодинг) и наоборот (обратный геокодинг).
  • Directions API: API навигации для построения автомобильных, велосипедных и пешеходных маршрутов.

  Пример работы с песочницей:

  

Управление стилями карты

Загрузка и применение стиля карты

Вы можете создать уникальный стиль карты и использовать его в своём контуре.

1. Убедитесь, что в составе сервисов карт установлен Styles API.

2. Откройте Редактор стилей и создайте стиль карты.

   См. инструкции по созданию и настройке стилей в документации Редактора стилей.

3. Выгрузите созданный стиль из Редактора стилей:

   1. В Редакторе стилей в блоке Мои стили откройте карточку нужного стиля.

   2. В верхнем меню нажмите Поделиться, а затем в открывшемся окне нажмите Экспорт стиля.

      

   3. Отметьте необходимый стиль в списке и нажмите Экспортировать.

      В новой панели начнётся подготовка архива для скачивания.

   4. Когда стиль будет в статусе Готово, выберите его в списке и нажмите Скачать стиль.

   5. Сохраните созданный архив в формате .tar.gz локально.

4. Загрузите стиль в контур On-Premise:

   1. Откройте Менеджер Платформы в браузере.
   2. Перейдите на вкладку Стили карты и нажмите Загрузить стиль.
   3. Добавьте скачанный архив в формате .tar.gz и дождитесь его успешной загрузки (архив должен перейти в статус Загружено).

5. Чтобы проверить, как выглядит загруженный стиль в песочнице, на вкладке Стили карты нажмите на название нужного стиля.

6. Скопируйте сгенерированный ID стиля в поле ID стиля карты и примените его к карте с помощью MapGL JS API.

Вы можете загружать разные версии одного стиля и переключаться между ними в Менеджере Платформы: подробнее см. в разделе Обновление стиля карты.

Обновление стиля карты

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

1. Откройте Редактор стилей и создайте новый стиль или отредактируйте существующий.

   См. инструкции по созданию и настройке стилей в документации Редактора стилей.

2. Выполните шаги по выгрузке стиля из Редактора стилей и загрузке в Менеджер Платформы.

3. Если вы загружаете обновлённую версию существующего стиля, его ID остаётся прежним. Менеджер Платформы распознает обновление как новую версию стиля. В дальнейшем вы сможете переключаться между версиями одного стиля.

4. Если вы загружаете новый стиль, скопируйте сгенерированный ID стиля в поле ID стиля карты и примените его к карте с помощью MapGL JS API.

Удаление стиля карты

Важно

Перед удалением стиля убедитесь, что он не применён ни к одной из действующих карт. В противном случае после удаления стиля карта может отображаться некорректно.

1. Откройте Менеджер Платформы в браузере.
2. Перейдите на вкладку Стили карты и нажмите рядом с нужным стилем.

Просмотр статистики

На вкладке Статистика вы можете посмотреть подробные данные о количестве запросов. Вы можете отфильтровать данные по временному периоду, сервису и API-ключу. Пример отображения статистики:

На графике отображается количество запросов к сервисам за каждый день выбранного периода.

Примечание

Данные на всех графиках обновляются с задержкой в несколько минут.

Статистика распределения запросов

Чтобы посмотреть статистику распределения запросов:

1. Перейдите на вкладку Статистика.

2. Выберите период, за который нужно получить статистику (сегодня, последняя неделя, месяц, год), или укажите произвольный период в поле Период. Дата и время указываются в формате UTC.

3. В поле Ключ выберите ключи доступа, по которым нужно получить статистику. Чтобы выбрать все ключи, выберите Выбрать все.

   Чтобы отфильтровать ключи по статусу и режиму использования, нажмите значок , выберите статус ключа (Активен, Неактивен) и режим (Demo для демо-ключа и Prod для основного ключа).

4. В поле Сервис выберите сервисы, по которым нужно получить статистику. Чтобы выбрать все сервисы, выберите Выбрать все.

Скачивание файла со статистикой

Вы можете скачать статистику в виде файла с таблицей в формате .xlsx. Таблица содержит следующие поля:

• Ключ: ID ключа.
• Дата: дата запроса.
• Сервис: сервис, к которому был отправлен запрос.
• Режим: режим использования ключа (демо-ключ demo или основной ключ prod).
• Метод: endpoint, к которому был отправлен запрос.
• Результат: результат запроса (Успех, Пустой ответ, Ошибка).
• Код результата: код результата запроса.
• Количество запросов: количество запросов в течение дня, указанного в дате.
• Организации: количество организаций, полученных через Places API, Suggest API и Markers API.
• Геообъекты: количество геообъектов, полученных через API поиска.
• Маршруты: количество маршрутов, построенных через API навигации, кроме Isochrone API.

Чтобы скачать файл со статистикой распределения запросов:

1. Перейдите на вкладку Статистика.
2. Выберите период, ключи и сервисы.
3. Нажмите Скачать в формате XLSX.