• ドキュメント
• SORACOM Harvest
• Getting Started

Harvest Files の画像を SORACOM Lagoon で表示する

このドキュメントでは、Harvest Files にデバイスの画像ファイルを保存し、その画像ファイルを SORACOM Lagoon でダッシュボード化する手順を紹介します。当ガイドの前提は以下のとおりです。

• SORACOM のアカウントを作成済みであること
• SORACOM Air の SIM、および使用できるデバイスが準備されていること
• SORACOM Lagoon が準備されていること

ステップ 1: デバイスのファイルを Harvest Files に送信する 

SIM をグループに所属させる 

SORACOM Harvest Files の設定はグループ単位で行います。そのため、Harvest Files を使うには IoT SIM をグループに登録する必要があります。今回は、動作確認として SORACOM Harvest Files のグループを作成し、そのグループに SIM を登録します。

まず SIM 管理画面を開いて、SORACOM Harvest Files でファイルを収集したい SIM にチェックマークを付けます。続いて、[操作] → [所属グループ変更] を選択します。

IoT SIM の所属グループを選択するためのダイアログが表示されたら、[新しい所属グループ] → [新しいグループを作成…] を選択します。

以下のようなグループ作成ダイアログが表示されます。グループの名称を入力して [グループ作成] ボタンをクリックします。 今回は harvest-files-demo というグループ名で作成します。

[グループ作成] ボタンを押すと元の [SIM の所属グループ変更] ダイアログに戻ります。 [新しい所属グループ] ドロップボックスが、今作成した harvest-files-demo グループになっていることを確認し [グループ変更] ボタンを押します。

続いて、Harvest Files を有効化します。

Harvest Files を有効化する 

Harvest Files は、設定を有効化すればすぐにファイルを送信できます。Harvest Files の設定を有効化した状態で、SORACOM Air の SIM から通信を行っているデバイスから、Harvest Files のエントリポイントへファイルを送信すると SORACOM のプラットフォーム上にファイルが保存されていきます。

SORACOM Harvest Files へ送信したファイルについてパスなどの情報を SORACOM Harvest Data へ連携することで、SORACOM lagoon での可視化ができます。

先ほど作成した SIM グループ (harvest-files-demo) から [SORACOM Harvest Files 設定] 以下のように [Harvest Files] と [HARVEST DATA 連携] を有効にして連携対象のファイルパスを /lagoon/.* と設定します。 Harvest Files の /lagoon 以下に格納されたデータは自動で Harvest Data にも連携されます。

グループ設定の詳細は リファレンス: グループ設定 をご確認ください。

HTTP でファイルを送信する 

Harvest Files は HTTP に対応しています。Harvest Files エントリポイント(セルラー) 宛に HTTP POST もしくは PUT リクエストを送信してください。

今回は以下のように先ほど指定した /lagoon というパスに対して /harvest.png という画像データを保存します。

curl -v -X PUT --data-binary @harvest.png -H "content-type:image/png" http://harvest-files.soracom.io/lagoon/harvest.png

ステップ 2: Harvest Files に収集されたファイルを確認する 

ユーザーコンソールでは、Harvest Files で保存されたファイルを確認およびダウンロードできます。

[Menu] → [データ収集・蓄積・可視化] → [SORACOM Harvest Files] から、/lagoon/ ディレクトリをクリックします。

保存されたファイルは当メニューから確認およびダウンロードできます。

また、[Menu] → [データ収集・蓄積・可視化] → [SORACOM Data] から対象の SIM を選択すると、以下のように Harvest Files のファイルの URL の情報が Harvest Data に連携されていることが確認できます。

ステップ 3: SORACOM Lagoon で Harvest Files に保存した画像を表示する 

Harvest Files に保存した画像を SORACOM Lagoon で表示します。

Panel を作成し、Query タブに Harvest Files へファイルを送信した SIM の IMSI を入力します。右隣の欄 (データフォーマット) には文字列である URL を扱うため Table を選択します。

Panel タブの [Visualization] で SORACOM Dynamic Image Panel を選択し、の [Mode] で Harvest Files を、[Name] で A-url を選択します。

以下のように Harvest Files に格納した画像ファイルが表示されます。 画像は、Harvest Data に送信された最新の URL を参照します。

同一の SIM で画像以外のデータを Harvest Data に送信したい場合 

SORACOM Lagoon Dynamic Image Panel で SORACOM Harvest Files の画像を表示する際は、最新データの url の値を参照します。同一の SIM にて画像の URL 以外のデータを SORACOM Harvest Data に送信すると、タイミングによっては最新データに url が含まれていないことがあり画像が表示されません。(例：Raspberry Pi から送信した画像を SORACOM Lagoon Dynamic Image Panel に表示させ、且つ温度センサーで取得したデータを SORACOM Harvest Data に送信する場合など。)

その場合は、SORACOM Lagoon の Transformation 機能を使うことで実現できます。

1. SORACOM Dynamic Image Panel の [Transform] タブを開く
2. 以下のように [Filter data by values] で url match Is not null と設定する