Soracom

Users

ドキュメント

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

Harvest Files にデバイスの画像ファイルを保存して、その画像ファイルを Lagoon のダッシュボードに表示します。

操作を始める前に準備が必要です (クリックして確認してください)

(1) SORACOM Air for セルラーの IoT SIM、および IoT SIM を利用できるデバイスを準備する

各種デバイスでの IoT SIM の使用方法については 各種デバイスで SORACOM Air を使用する を参照してください。

(2) Lagoon の利用を開始する

Lagoon の利用を開始します。詳しくは、SORACOM Lagoon の利用を開始する を参照してください。

準備完了

SORACOM Lagoon の Snapshot では、Harvest Files の画像を表示できません。

ステップ 1: Harvest Files を有効化する

SORACOM Lagoon で可視化するために、Harvest Files の /lagoon 以下に保存されたデータについて、パスなどの情報を自動的に Harvest Data に連携するように設定します。

Harvest Files の設定はグループに対して行います

ここでは、グループの設定を変更する操作のみを説明します。グループの仕組みやグループを作成する操作について詳しくは、グループ設定 を参照してください。

  1. SIM グループ画面で [SORACOM Harvest Files 設定] をクリックします。

    SIM グループ画面を表示する操作について詳しくは、グループの設定を変更する を参照してください。

  2. スイッチをクリックして「ON」にします。

  3. 以下の項目を設定し、[保存] をクリックします。

    設定項目
    [HARVEST DATA 連携]ON
    [連携対象のファイルパス]/lagoon/.*

  4. IoT SIM が所属するグループを切り替えます。

    IoT SIM から送信したデータが Harvest Files に保存できるようになりました。

ステップ 2: デバイスから HTTP でファイルを Harvest Files に送信する

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

Harvest Files は、設定を有効化すればすぐにファイルを送信できます。Harvest Files の設定を有効化した状態で、SORACOM Air の SIM から通信を行っているデバイスから、Harvest Files の HTTP (セルラー通信経由のアップロード) のエントリポイント に HTTP POST もしくは PUT リクエストを送信すると SORACOM のプラットフォームにファイルが保存されます。

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

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

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

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

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

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

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

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

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

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

lagoon-soracomdynamicimage_panel lagoon-soracomdynamicimage_panel

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

lagoon-soracomdynamicimage_panel lagoon-soracomdynamicimage_panel

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

lagoon-soracomdynamicimage_panel 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 values]url match Is not null と設定する

lagoon-transformation-setting lagoon-transformation-setting