Подключение специфичных функций

Подключение Яндекс Карт

В DataLens доступна схематическая карта мира. Но для работы с геолокацией на территории России и СНГ и использования слоев Спутник и Гибрид необходима интеграция с сервисом Яндекс Карты.

Примечание

Посмотреть примеры использования геоаналитики можно на демодашборде.

image

Что требуется от администратора

Получить API-ключ. Ваша организация должна получить API-ключ для JavaScript API и Geocoding API. Это коммерческий продукт, его использование регулируется отдельным договором.

Включить функцию. Это можно сделать двумя способами:

  1. Базовый

    Функцию карт можно включить через добавление двух параметров при инициализации:

    ./init.sh --yandex-map --yandex-map-token <ваш_api_ключ_от_яндекс_карт>
            
  2. Продвинутый

    Совет

    values.yaml должен содержать полную конфигурацию.

    1. Настроить values.yaml.

      После получения ключа его нужно прописать в конфигурации DataLens.

      # в вашем файле values.yaml
              features:
                yandex_map:
                  enabled: true
                  token: 'ВАШ_API_КЛЮЧ_ОТ_ЯНДЕКС_КАРТ'
              
    2. Применить конфигурацию.

      Выполните ./init.sh --values <ваш_файл>.yaml, чтобы изменения вступили в силу.

      После этого у пользователей в настройках карт появится возможность выбирать слои Яндекс Карты.

Chart Editor

Примечание

Chart Editor — это «песочница» для продвинутых пользователей и разработчиков, которая позволяет создавать визуализации не из стандартного набора.

Как это работает:

  • Пользователь пишет код на JavaScript.

  • В коде могут использоваться библиотеки для создания сложных диаграмм или Gravity UI Charts, которая используется и самим DataLens.

    Пример из документации.

  • Данные для визуализации могут поступать из датасета или через JSON API Connector.

    Пример из документации.

Примечание

Посмотреть разные способы применения Chart Editor можно на Editor Demo Dashboard.

Что требуется от администратора

Работа администратора здесь проста — только включить эту возможность. Есть два способа:

  • Базовый

    Функцию Chart Editor можно включить через добавление параметра:

    ./init.sh --editor
            
  • Продвинутый

    Примечание

    values.yaml должен содержать полную конфигурацию.

    1. Настроить values.yaml.

    После получения ключа его нужно прописать в конфигурации DataLens.
            
            ```yaml
            # в вашем файле values.yaml
            features:
              editor:
                enabled: true
            ```
            
    1. Применить конфигурацию.

      Выполните ./init.sh --values <ваш_файл>.yaml, чтобы изменения вступили в силу.

      После применения этой настройки у пользователей при создании чарта появится новый тип — Chart Editor. Администратор не обязан уметь писать код для Chart Editor, его задача — предоставить пользователям такую возможность.

Кейс

Аналитик просит вас включить слой Спутник на картах в DataLens. Что из перечисленного является обязательным условием для выполнения этой задачи?

  • Включить features.editor.enabled: true

  • Получить коммерческий API-ключ для Яндекс Карт и прописать его в values.yaml

  • Увеличить количество реплик пода data-api

  • Создать подключение к базе данных с геокоординатами

Узнать ответ
  • Включить features.editor.enabled: true

    Неверно. Chart Editor — это отдельная функция для кастомных визуализаций, она не связана с Яндекс Картами.

  • Получить коммерческий API-ключ для Яндекс Карт и прописать его в values.yaml

    Верно. Слои Спутник и Гибрид предоставляются коммерческим API Яндекс Карт и требуют наличия ключа.

  • Увеличить количество реплик пода data-api

    Неверно. Производительность data-api не влияет на доступность слоев карт.

  • Создать подключение к базе данных с геокоординатами

    Неверно. Это необходимо для создания чарта с картой, но не для включения самих слоев карт в интерфейсе.

Итоги

Теперь вы знаете, как расширить стандартную функциональность DataLens, предоставив пользователям доступ к Яндекс Картам и редактору чартов. Ваша роль как администратора — это включение и настройка платформы, а создание контента — задача аналитиков.