Soracom

Harvest Data に保存したデータを確認する

Harvest Data に送信されたデータを確認したりダウンロードしたりします。数値データや位置情報は、グラフや地図で確認できます。

1. ユーザーコンソール にログインし、データを送信した IoT SIM にあわせてカバレッジタイプを変更します。

   たとえば、plan01s の IoT SIM でデータを送信した場合は、グローバルカバレッジの表示に変更します。詳しくは、SORACOM ユーザーコンソールで表示するカバレッジタイプを変更する を参照してください。

2. [メニュー] → [SORACOM Air for セルラー] → [SIM 管理] の順にクリックします。

   SIM 管理画面が表示されます。

3. データを送信した IoT SIM にチェックを入れ、[操作] → [Harvest Data を表示] の順にクリックします。

   

   SORACOM Harvest Data 画面が表示され、Harvest Data に保存されたデータや、一次処理済みデータ、グラフ用データとして、以下のデータが表示されます。

   項目	説明
   [Content Type]	Harvest Data に保存されているデータの形式が表示されます。たとえば、以下のように表示されます。 Harvest Data に送信されたデータが JSON 形式のデータ として処理される場合は、「application/json」と表示されます。 Harvest Data に送信されたデータが テキストデータ として処理される場合は、「text/plain」と表示されます。 Harvest Data に送信されたデータが バイナリデータ として処理される場合は、JSON 形式に変換されたうえで保存されるため「application/json」と表示されます。
   [データ]	Harvest Data に保存されたデータが表示されます。 Harvest Data に送信されたデータが JSON 形式のデータ として処理される場合は、JSON 形式のまま保存されます。Harvest Data に保存される前に、バイナリパーサー や Orbit で処理された場合は、JSON 形式のデータとして Harvest Data に保存されます。 Harvest Data に送信されたデータが テキストデータ として処理される場合は、テキストデータのまま保存されます。 Harvest Data に送信されたデータが バイナリデータ として処理される場合は、payload 変換が行われたうえで保存されます。詳しくは、payload 変換について を参照してください。
   [一次処理済みデータ]	[Content Type] と [データ] の内容によって異なります。 [Content Type] が「application/json」で、[データ] に payload だけが含まれる場合は、payload 変換の逆変換が行われ、以下のようなデータが表示されます。 { "value":"{\"lat\":null,\"lon\":null,\"bat\":3,\"rs\":3,\"temp\":19.9,\"humi\":47.6,\"x\":null,\"y\":null,\"z\":null,\"type\":1}" } value の値 ({"value":"{\"lat\":null,...}"}) は、[データ] の payload の値 (eYJs...) を Base64 形式でデコードしたものです。 上記以外の場合は、[データ] と同じデータが表示されます。
   [グラフ用データ]	[一次処理済みデータ] に JSON 形式のデータが表示されている場合に、値が数値のものだけを抽出したデータが表示されます。 {"bat":3,"rs":3,"temp":19.9,"humi":47.6,"type":1} ただし、以下の場合は特別なデータ変換が行われます。 [一次処理済みデータ] に value だけが含まれる場合は、value の値 (例: {"value":"{\"lat\":null,...}"}) を JSON 形式のデータとみなして、値が数値のものだけを抽出します。 value の値が JSON 形式のデータではない場合は、{} が表示されます。 [一次処理済みデータ] の任意のキーに JSON オブジェクトが含まれる場合は、以下のようにデータ構造が変換されます。 [一次処理済みデータ] のデータ: gps に JSON オブジェクトが含まれています。 { "time": 123455656, "gps": { "lat": 23.354, "lon": 2.0, "speed": 123 } } [グラフ用データ] のデータ: gps に含まれていた JSON オブジェクトのキーに、gps. (プレフィックス) が付与されて、JSON オブジェクトが含まれない形に変換されています。 { "time": 123455656, "gps.lat": 23.354, "gps.lon": 2.0, "gps.speed": 123 } [Content Type] が「text/plain」の場合や、値が数値のものが無い場合は、{} が表示されます。

   たとえば、TCP や UDP で文字列の 123 や hello を送信した場合 (バイナリデータとして保存された場合) は、ユーザーコンソールでは以下のように表示されます。

   送信したデータ (文字列)	データ	一次処理済みデータ	グラフ用データ
   123	{"payload":"MTIz"}	{"value":"123"}	{"value":123}
   hello	{"payload":"aGVsbG8="}	{"value":"hello"}	{}

   SORACOM Harvest Data 画面の主な機能:

   

   • [自動更新 (5 秒)] を ON にすると、5 秒おきに新しいデータを取得します。ただし複数のデバイスのグラフを表示させる場合は 60 秒ごとに更新されます。
   • グラフで確認する手順については、[グラフ用データ] (数値データ) をグラフ化する を参照してください。
   • 地図で確認する手順については、[グラフ用データ] (数値データ) の位置情報を地図に表示する を参照してください。
   • [ダウンロード] をクリックすると、JSON 形式でダウンロードできます。詳しくは、Harvest Data に格納されたデータをダウンロード (バックアップ) する を参照してください。

   Harvest Data へ送信するデータの種類に制限はありませんが、上記のルールで [グラフ用データ] にデータが表示されない場合は、グラフ化したり、地図にマッピングしたりできません。

payload 変換について

Harvest Data に送信されたデータが バイナリデータ として処理される場合は、payload 変換が行われたうえで保存されます。たとえば、Harvest Data に TCP や UDP で送信した場合は、JSON 形式のデータと同じフォーマットでも、バイナリデータとして Harvest Data に保存されます。

payload の値 (eyJs...) は、デバイスから送信した JSON 形式のデータを Base64 形式でエンコードしたものです。これを、payload 変換と呼びます。

{
  "payload": "eyJsYXQiOm51bGwsImxvbiI6bnVsbCwiYmF0IjozLCJycyI6MywidGVtcCI6MTkuOSwiaHVtaSI6NDcuNiwieCI6bnVsbCwieSI6bnVsbCwieiI6bnVsbCwidHlwZSI6MX0="
}

{"data": [{"time": "2025-03-17T09:00:00+09:00", "temperature": 10.5}, {"time": "2025-03-18T09:00:00+09:00", "temperature": 9.4}]}

payload 変換されたデータから元のデータを取り出すには

payload 変換されたデータから元のデータを取り出すには、payload の値 (eYJs...) を Base64 形式でデコードしてください。たとえば、以下のコマンドで元のデータを取り出せます。

$ echo 'eyJsYXQiOm51bGwsImxvbiI6bnVsbCwiYmF0IjozLCJycyI6MywidGVtcCI6MTkuOSwiaHVtaSI6NDcuNiwieCI6bnVsbCwieSI6bnVsbCwieiI6bnVsbCwidHlwZSI6MX0=' | base64 --decode

{"lat":null,"lon":null,"bat":3,"rs":3,"temp":19.9,"humi":47.6,"x":null,"y":null,"z":null,"type":1}

ただし、送信したデータがバイナリデータの場合は、上記のコマンドではバイナリデータは確認できません。xxd コマンドなどを利用して、16 進数に変換してください。

$ echo 'AAYBAgMEBQZJFw==' | base64 --decode | xxd -p

00060102030405064917

[グラフ用データ] (数値データ) をグラフ化する

ユーザーコンソールでは、[グラフ用データ] に表示されるデータをグラフ化できます。グラフの種類は「折れ線グラフ」「集合棒グラフ」「積み上げ棒グラフ」から選択できます。

[グラフ用データ] (数値データ) の位置情報を地図に表示する

Harvest Data に位置情報 (緯度、経度) が保存されている場合は、[] をクリックすると、位置情報に基づいて地図に点が表示されます。

緯度と経度は、デフォルトでは [グラフ用データ] の以下のプロパティから取得されます。

• 緯度: lat または latitude
• 経度: lon、longitude、lng、または long

Harvest Data に保存したデータを削除する

データ保持期間中にデータを削除するには、SORACOM Harvest Data 画面で削除するデータにチェックを入れて、[削除] をクリックします。