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

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

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

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

1. Получить API-ключ.

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

   Примечание

   При отсутствии ключа функция будет работать, пока не исчерпает лимит по количеству бесплатных запросов в сутки.

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

   • Базовый

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

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

   • C отдельным values-файлом

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

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

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

```yaml
# в вашем файле values.yaml
features:
yandex_map:
    enabled: true
    token: 'ВАШ_API_КЛЮЧ_ОТ_ЯНДЕКС_КАРТ' # если не используете ключ, то удалите эту строку
```

1. Применить конфигурацию.

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

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

EditorEditor

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

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

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

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

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

Посмотреть разные способы применения Editor можно на демодашборде DataLens Editor.

Пример построения таблиц на основе датасета — в статье «Создание таблицы на основе датасета».

Пример построения таблицы на основе API Connector — в статье «Создание таблицы через API».

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

Editor активируется аналогично другим функциям параметром --editor.

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

API ConnectorAPI Connector

API Connector позволяет подключаться к произвольным HTTP API прямо из DataLens и использовать полученные данные для построения чартов в Editor.

Что умеетЧто умеет

• отправлять GET- и POST-запросы к любому доступному API;
• работать по HTTP и HTTPS;
• передавать открытые заголовки: Accept-Charset, Accept-Encoding, Accept-Language, Prefer;
• передавать приватные (зашифрованные) заголовки для аутентификации: Authorization, X-Api-Key, X-ClickHouse-User, X-ClickHouse-Key.

Как попробоватьКак попробовать

1. В воркбуке нажмите Создать → Подключение.
2. В разделе Файлы и сервисы выберите API Connector.
3. Укажите хост, порт, путь к эндпоинту и разрешенные методы.
4. При необходимости добавьте заголовки авторизации — они будут храниться в зашифрованном виде.
5. Сохраните подключение и используйте его в Editor-чартах.

Подробнее можно почитать в статье Создание подключения API Connector.

КейсКейс

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

• Включить features.editor.enabled: true.
• Получить коммерческий API-ключ для Яндекс Карт и прописать его в values.yaml.
• Увеличить количество реплик пода data-api.
• Создать подключение к базе данных с геокоординатами.

ИтогиИтоги

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