Soracom

SORACOM Harvest Data (以下、Harvest Data) に保存されたデータを、期間を指定して一括ダウンロードできます。

SORACOM Harvest Data 画面に表示されたデータをダウンロードする

ユーザーコンソールの SORACOM Harvest Data 画面に表示されたデータは、CSV 形式や JSON 形式でダウンロードできます。

1. ユーザーコンソール にログインし、ダウンロードするデータにあわせてカバレッジタイプを変更します。

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

2. [メニュー] → [データ収集・蓄積・可視化] → [SORACOM Harvest Data] の順にクリックします。

3. [リソース] をクリックし、ダウンロードするデータを送信していた IoT SIM を 1 つだけ選択します。

   複数のリソースを選択してもまとめてダウンロードできません

   Harvest Data 画面で手順 3 を繰り返すと複数のリソースを選択できます。ただし、ここで複数のリソースを選択しても、手順 5 の [対象] で 1 つのリソースを選択し直します。複数のリソースのデータをまとめてダウンロードすることはできません。

4. [ダウンロード] をクリックします。

   Harvest Data ダウンロード画面が表示されます。

5. ダウンロードするデータの条件を指定します。

   項目	説明
   [対象期間]	ダウンロードするデータを送信した日時を指定して、ダウンロードするデータを絞り込めます。 最大 1,000 件のデータをダウンロードできます 対象期間の設定に関わらず、1,000 件を超えるデータはダウンロードできません。
   [対象]	ダウンロードするデータを送信したリソースの ID (例: IoT SIM の SIM ID) を 1 つ指定します。複数のリソースを選択することはできません。
   [フォーマット]	ダウンロードフォーマットを指定します。 [データをダウンロード (JSON 形式)]: Harvest Data に格納されたデータをダウンロードします。以下のような JSON 配列形式となります。 [ { "resourceType": "Subscriber", // リソースの種類。SIM の場合は Subscriber "resourceId": "295050910008582", // リソースの ID "time": "2021-10-22T06:31:41.468+09:00", // 受信した日付と時刻 "contentType": "application/json", // Content type "content": { "elevation": 17.2, "battery": 2 } // デバイスから送信されたデータ。バイナリ形式の場合は Base64 形式 }, { "resourceType": "Subscriber", "resourceId": "295050910008582", "time": "2021-10-22T06:31:41.467+09:00", ... }, ... ] [グラフ用データをダウンロード (JSON 形式)]: グラフ用に変換されたデータ ("値名":数値 となっている部分を抽出したデータ) を JSON 形式でダウンロードします。 [ { "resourceType": "Subscriber", // リソースの種類。SIM の場合は Subscriber "resourceId": "440103213043029", // リソースの ID "time": "2021-10-22T06:31:41.468+09:00", // 受信した日付と時刻 "chartData": { "elevation": 17.2, "battery": 2 } }, { "resourceType": "Subscriber", "resourceId": "440103213043029", "time": "2021-10-22T06:31:41.467+09:00", ... }, ... ] [グラフ用データをダウンロード (CSV 形式)]: グラフ用に変換されたデータを CSV 形式でダウンロードします。 __resourceType,__resourceId,__time,__iso8601Time,elevation,battery "Subscriber","440103213043029","2021/10/22 06:31:41","2021-10-22T06:31:41.468+09:00","17.2","2" "Subscriber","440103213043029","2021/10/22 06:31:41","2021-10-22T06:31:41.467+09:00",... ...

6. [ダウンロード] をクリックします。

SORACOM CLI / SORACOM API の場合

SORACOM CLI または SORACOM API を利用すると、指定したリソースのすべてのデータをダウンロードできます。

$ soracom sims get-data --sim-id ${sim_id} --from ${from} --to ${to}
[
  {
    "content": "{\"elevation\": 17.2, \"battery\": 2 }",
    "contentType": "application/json",
    "time": 1634851840992
  },
  {
    "content": "...",
    "contentType": "application/json",
    "time": 1634851840991
  },
  ...
]

$ curl -v -X GET "https://api.soracom.io/v1/sims/${sim_id}/data?from=${from}&to=${to}" \
-H "X-Soracom-API-Key: ${X_SORACOM_API_KEY}" \
-H "X-Soracom-Token: ${X_SORACOM_TOKEN}"
[
  {
    "content": "{\"elevation\": 17.2, \"battery\": 2 }",
    "contentType": "application/json",
    "time": 1634851840992
  },
  {
    "content": "...",
    "contentType": "application/json",
    "time": 1634851840991
  },
  ...
]