Пользовательский виджет "Картосхема"

Owned by Visiology Robot (Unlicensed)
Last updated: авг. 01, 2023 by Эдуард Столяр
3 min read

Вы можете создать собственный виджет, который позволит добавлять в ваши дашборды карту с визуализацией данных. Для этого необходимо:

  1. Создать карту на основе которой будет построен виджет и добавить её на сервер.

  2. Создать новый виджет-картосхему.

Добавление карты

  1. Создайте векторное изображение картосхемы в редакторе SVG файлов, или скачайте готовый файл из интернета.

  2. Откройте получившийся файл в редакторе кода.

  3. Скопируйте получившийся код и вставьте в форму кода на портале https://highcharts.github.io/map-from-svg/.

  4. Нажмите кнопку Load и посмотрите, что получилось справа:


     

  5. Кликните на View Highcharts Maps config и скопируйте код карты в окне справа:

     

  6. Вставьте код в блокнот и добавьте каждому контуру региона следующие параметры:

    • hc-code – ID региона, который вы потом сможете использовать в таблицах и т.д. Можно, например, использовать код ОКАТО региона;

    • short-name – неполное название региона. Например, Коми;

    • full-name – полное название региона. Например, Республика Коми.
      Например:

      "full-name": "Республика Саха (Якутия)", "short-name": "Якутия", "hc-code": "98000000000",

  7. Сохраните получившийся код в формате *.js.

  8. Назовите файл, например, russia_wiki.js.

  9. Добавьте получившийся файл на сервер в папку по адресу /docker-volume/dashboard-viewer/customjs.
    Образец готового файла: russia_regions.js

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

Создание виджета

Карта создана и добавлена на сервер. Теперь необходимо создать новый виджет с этой картой в Dashboard Designer. Для этого выполните следующие шаги:

  1. Откройте приложение Dashboard Designer.

  2. На вкладке Пользовательские виджеты, нажмите кнопку Создать:

     

  3. В открывшемся окне введите название виджета.

  4. В поле Код виджета (JavaScript) вставьте код из файла widgets_kod.js: widgets_kod.js

  5. Нажмите кнопку Создать:

     

  6. Добавьте виджет в рабочую область.

  7. На вкладке Привязка данных, привяжите виджет к данным:


Виджет отобразит загруженные данные:

Важно!

Для корректного отображения информации, в данных должны быть указаны геокоды, например, как один из атрибутов измерений. Данные геокоды должны соответствовать значениям hc-code из файла карты (в нашем примере это russia_wiki.js).

Пример

Рассмотрим пример подготовки данных для работы с картосхемой:

  1. Создайте измерение, одним из атрибутов которых будет геокод из файла карты (в нашем случае это файл russia_wiki.js).


     

  2. Укажите в свойствах элементов измерения данные из файла russia_wiki.js:

     

  3. При привязке данных к созданному виджету Картосхема в Dashboard Designer, укажите геокод в качестве одного из измерений:

     

  4. Данные отобразятся на картосхеме:

Смотрите также

На этой странице

Нужна дополнительная помощь?

Свяжитесь с технической поддержкой
Или нажмите  в приложении, чтобы задать вопрос.