MENU

Soracom

Users

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 FilesHARVEST DATA 連携 を有効にして連携対象のファイルパスを /lagoon/.* と設定します。 Harvest Files の /lagoon 以下に格納されたデータは自動で Harvest Data にも連携されます。

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

Harvest Files はアップロードが完了したファイルのサイズによって料金が発生します。詳しくは 料金表 を確認してください。

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 を選択します。

lagoon-soracomdynamicimage_panel

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

lagoon-soracomdynamicimage_panel

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

lagoon-soracomdynamicimage_panel

同一の 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 valuesurl match Is not null と設定する

lagoon-transformation-setting