Looker Visualization API — это программный интерфейс и набор инструментов, предназначенных для создания, интеграции и настройки пользовательских визуализаций в рамках платформы бизнес-аналитики Looker и связанных продуктов. API предоставляет разработчикам возможности писать визуализации на JavaScript, регистрировать их в окружении отчётов и дашбордов, а также управлять параметрами отображения, зависимостями и поведением при взаимодействии с данными. Взаимодействие обычно происходит через подключение визуализационных модулей по URL или через загрузку файлов в среду проекта.
Исторически функциональность такого рода появилась как ответ на потребность в расширяемости стандартного набора диаграмм и виджетов: платформы аналитики предоставляют базовые графики, а Visualization API позволяет реализовать специфичные для бизнеса или отрасли представления данных. API обычно включает методы для инициализации визуализации, получения и обновления данных, реакций на изменение размеров контейнера и управления пользовательскими настройками. Документация и примеры кода помогают интегрировать созданные компоненты в пайплайн отчётов без изменения ядра платформы.
- Поддержка JavaScript-визуализаций: возможность писать визуализации на стандартных веб-технологиях (JavaScript, SVG, Canvas, WebGL) и использовать внешние библиотеки внутри ограничений окружения.
- Регистрация и подключение: механизмы регистрации пользовательских визуализаций в системе, подключение через URL или загрузку файлов в проект.
- API и lifecycle-методы: набор событий и методов для инициализации, рендера, обновления и уничтожения визуализаций, включая обработку изменений данных и размера контейнера.
- Конфигурация и настройки: декларативные схемы для задания пользовательских опций, параметров отображения и типов входных данных, доступных через интерфейс настройки визуализации.
- Доступ к данным и метаданным: стандартизированный формат передачи табличных данных, полей и метаданных отчёта в визуализационный компонент.
- Изоляция и безопасность: механизмы изоляции кода и управления зависимостями, позволяющие ограничить влияние пользовательских скриптов на платформу и взаимодействовать с разрешёнными ресурсами.
- Интеграция с дашбордами: поддержка взаимодействия визуализаций с элементами дашборда, фильтрами и параметрами времени, а также реактивное обновление при изменении контекста отчёта.
- Тестирование и отладка: рекомендации и инструменты для локальной разработки, логирования и пошаговой отладки визуализаций перед деплоем в продакшен.
- Совместимость и миграция: указания по обеспечению совместимости с различными версиями платформы и по миграции пользовательских визуализаций при обновлении среды.
- Ограничения и рекомендации: описания ограничений по производительности, объёму передаваемых данных и использованию сторонних ресурсов, а также лучшие практики по оптимизации рендеринга.