SaaS版Qlik Senseのマップチャートにフロアマップ画像を配置する – メディアライブラリとqlik-cliの活用

1. Qlik Tips
SaaS版Qlik Senseのマップチャート
に
フロアマップ画像を配置する
– メディアライブラリとqlik-cliの活用
2023/7/25
クリックテック・ジャパン株式会社

2. 2
2
Qlik Sense SaaSにはマップチャートが用意されていま
すが、地図画像の代わりにQlik Sense SaaS上に「アッ
プロードした画像ファイル」を配置し、その上にレイヤー
によるポイント表示などを行えることをご存知でしょう
か？
画像ファイルは「アプリに付随するコンテンツ(メディア
ライブラリ)」として、Web画面上からまたはQlik Sense
APIを実装したコマンドラインツール(qlik-cli)からアップ
ロード可能です。このスライドでは、マップチャートでの
フロアマップの実現方法を紹介します。
• SaaS版Qlik Senseの地理分析機能
• SaaS版Qlik Senseに画像ファイルをアップロード
• マップチャートの編集 - レイヤーの配置と表示用データ
アジェン
ダ

3. 3
3
SaaS版Qlik Senseの
地理分析機能

4. 4
4
マップチャートの強力な視覚化機能
• サポートしているレイヤー
 ポイントレイヤー
 エリアレイヤー
 ラインレイヤー
 密度レイヤー
 チャートレイヤー
 背景レイヤー
地理データをマップ上に複数のレイヤーを重ねて表示

5. 5
ベースマップ
地球の地図が不要な場合は、ベースマップを消して、背景レイヤーを配置
する
• ベースマップは「なし」
• マップのプロジェクション(図法)は「ユーザー定義(メートル)」。緯度経
度が不要な場合
• 自動ズームはオンのままにしておくのが無難。初期表示位置が自動で決ま
るため

6. 6
マップチャートのスタイル
凡例(レイヤーの説明表示)、ナビゲーション(初期位置に戻るなど)、スケー
ル(距離)バー
×
×

7. 7
レイヤー
背景レイヤーは、地図画像の上に重ね書き可能
• 本来は、別の地図画像を重ねて配置する機能だが、画像は地図で無くても
良い
• 通常画像ファイルはQlik Sense外部のWebサーバーに置く(URLや認証な
どは考慮)
UI上は緯度・経度だが、
メートルに置き換えて考
える
単にUIの表記上の問題

8. 8
8
SaaS版Qlik Senseに
画像ファイルをアップ
ロード

9. 9
SaaS版Qlik Senseへのファイルのアップロード
データファイル(csvやエクセルのファイル)はスペースにアップロードで
きるが、その他は???
• html,css,jsファイル,画像ファイルなどのWebコンテンツはアップロー
ド不可であり、ユーザー独自のWebコンテンツをホストしてWebブラウ
ザアクセスする機能は無い
• た・だ・し、「メディアライブラリ」が使える!!
- アプリやシートのサムネイル画像として、アプリに付随する画像ファイルを
アップロード可能

10. 10
SaaS版Qlik Senseへのファイルのアップロード
(続き)
画像ファイルのアップロードと削除が可能なダイアログボックス

11. 11
メディアライブラリの仕様
制限(拡張子・最大サイズ)やアプリとの関係
• オンラインヘルプ >> メディア ライブラリへの画像のアップロード
- https://help.qlik.com/ja-JP/cloud-
services/Subsystems/Hub/Content/Sense_Hub/MediaLibrary/MediaLibrary-upload.htm
- メディアライブラリに画像をアップロードできます。Qlik SenseがサポートするWebブラウザの
制限により、画像の高さや幅、サイズをできる限り小さくすることをお勧めします。ファイルの
最大サイズは5MBです。次の形式がサポートされています。png、jpg、jpeg、およびgif。メ
ディアライブラリの[アプリ内]フォルダーに画像をアップロードできます。
• サムネイルとして使用するかどうかは自由
• アプリをエクスポートしてインポートすると、画像ファイルもコピーさ
れる
- 画像のURLはもちろん変わります。画像を示す固有のIDが新規に与えられる
- エクスポートされる.qvfファイル内には、画像データやファイル名が入って
いる
• オンプレ版のQlik Sense Enterprise for Windowsも同様
• 画像には固有のURLが与えられる

12. 12
画像のURLを知る簡単な方法 – Webブラウザで
Webブラウザの開発者機能で、画像の<image src=“….jpg“>タグを調べ
る
• [インスペクタ]で画像を指して、そのURLを知る
- 例: https://xxx.ap.qlikcloud.com/api/v1/apps/6f8c61f7-1a9d-407f-9535-
f1bb7cbae185/media/files/floor.png

13. 13
画像URLを取得する方法 – Qlik Sense APIで
Qlik Sense APIの呼び出しを実装したqlik-cliが便利
• Windows/Linux/macOS用のコマンドラインツール – Go言語製の“qlik”コマン
ド
- https://qlik.dev/toolkits/qlik-cli
• SlideShare >> [Qlik Sense SaaS向けコマンドラインツールのご紹介]
- https://www.slideshare.net/QlikPresalesJapan/qlik-sense-saas-windowslinuxmacosqlik
• アプリのIDを指定して、JOSNデータ内の”link”の値を参照
• アップロードは、同一名の画像ファイルがあれば先に削除(rm)してから、アップ
ロード(update)

14. 14
14
マップチャートの編集
レイヤーの配置と表示用デー
タ

15. 15
画像ファイルの大きさと、メートルとのマッピン
グ
画像ファイルを、マップチャート上で「縦横それぞれ何メートル(m)」と
して扱うのか？
• 画像ファイルのピクセル数(幅・高さ)を、メートル(X座標・Y座標)に変換
- 例: 1ピクセルを10メールとして換算。フロアの実際の広さとは関係無い
- 換算率には特に決まりは無いが、大きいほうがマップチャートのズームがより
活かせる
• レイヤーに表示する実際の位置データも原点座標や換算率を基に調整する
必要あり
幅(X)=708, 高さ(Y)=459
7080m
Y(m)
X(m)
(0,0)
4590m
(7080,4590)

16. 16
透明で小さいポイントレイヤー(左下・右上の2点)の
追加
背景レイヤーを画面全体に(初期)表示するための目印用データとして利用
• 適当な計算軸で構わない。データモデルに入れな
い
UI上は緯度・経度だが、
メートルに置き換えて考
える
単にUIの表記上の問題
ロードスクリ
プトで
定義・後述

17. 17
背景レイヤーの追加
アプリに付随するメディアライブラリの画像ファイルのURLを利用
• 画像の左下隅(XYの原点)と画像の右上の端を指定(ロードスクリプトで定
義・後述)
UI上は緯度・経度だが、
メートルに置き換えて考
える
単にUIの表記上の問題
透明で小さいポイントレイ
ヤー

18. 18
ロードスクリプト
ポイントレイヤー用データを準備
• 各種変数の定義
• ポイント(X,Y座標)データ
• 表示用にポイントデータを調整

19. 19
分析用データをポイントレイヤーとして表示
X,Y座標の位置に●を表示し、大きさを数式で指定

20. Thank You!