Harvest Files の画像を SORACOM Lagoon で表示する
このドキュメントでは、Harvest Files にデバイスの画像ファイルを保存し、その画像ファイルを SORACOM Lagoon でダッシュボード化する手順を紹介します。当ガイドの前提は以下のとおりです。
- SORACOM のアカウントを作成済みであること
- SORACOM Air の SIM、および使用できるデバイスが準備されていること
- SORACOM Lagoon が準備されていること
注意
SORACOM Lagoon の Snapshot では、Harvest Files の画像を表示できません。
ステップ 1: Harvest Files を有効化する
SORACOM Lagoon で可視化するために、Harvest Files の /lagoon
以下に保存されたデータについて、パスなどの情報を自動的に Harvest Data に連携するように設定します。
Harvest Files の設定はグループに対して行います
ここでは、グループの設定を変更する操作のみを説明します。グループの仕組みやグループを作成する操作ついて詳しくは、グループ設定 を参照してください。
SIM グループ画面で
をクリックします。SIM グループ画面を表示する操作について詳しくは、グループの設定を変更する を参照してください。
スイッチをクリックして「ON」にします。
以下の項目を設定し、
をクリックします。設定 項目 ON /lagoon/.*
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 で保存されたファイルを確認およびダウンロードできます。
/lagoon/
ディレクトリをクリックします。
保存されたファイルは当メニューから確認およびダウンロードできます。
また、
→ → から対象の SIM を選択すると、以下のように Harvest Files のファイルの URL の情報が Harvest Data に連携されていることが確認できます。
ステップ 4: SORACOM Lagoon で Harvest Files に保存した画像を表示する
Harvest Files に保存した画像を SORACOM Lagoon で表示します。
Panel を作成し、Query タブに Harvest Files へファイルを送信した SIM の IMSI を入力します。右隣の欄 (データフォーマット) には文字列である URL を扱うため Table
を選択します。
Panel タブの
で SORACOM Dynamic Image Panel を選択し、の で Harvest Files を、 で 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 機能を使うことで実現できます。
- SORACOM Dynamic Image Panel の タブを開く
- 以下のように
url match Is not null
と設定する で