Soracom

通常、Harvest Data におけるデータのタイムスタンプは「SORACOM がデータを保存した時刻」です。このタイムスタンプを「送信データに含めた時刻」に変更できます。

「2024-09-02 12:34:56.789 (UTC) に送信したデータ」として Harvest Data に保存する例:

{
  "temperature": 12.3,
  "humidity": 45.6,
  "time": "2024-09-02T12:34:56.789Z"
}

{
  "temperature": 12.3,
  "humidity": 45.6,
  "date": "2024-09-02",
  "time": "12:34:56.789"
}

ユーザーコンソールで機能を有効化する

あらかじめユーザーコンソールで、デバイスから Harvest Data に送信するデータに含めた時刻をタイムスタンプとして利用できるように設定します。

1. SIM グループ画面、LoRaWAN グループ画面、Sigfox グループ画面、またはデバイスグループ画面で [SORACOM Harvest Data 設定] をクリックします。

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

3. [送信データの時刻をタイムスタンプに利用する] のスイッチをクリックして有効化します。

4. 以下の項目を設定します。

   項目	説明
   [送信データ形式]	Harvest Data に送信するデータ形式です。「JSON」を選択します。
   [時刻への JSON Pointer]	時刻データを保持するプロパティを JSON Pointer (RFC 6901) で設定します。 たとえば、デバイスが以下のような JSON を送信するときは、「/time」を入力します。 { "temperature": 12.3, "humidity": 45.6, "time": "2024-09-02T12:34:56.789Z" } [一括書き込み] が有効化されているときは配列内の各データをルートとした、相対的な JSON Pointer を設定します たとえば、デバイスが以下のような JSON を送信する場合は、[データ配列への JSON Pointer] に「/data」を入力し、[時刻への JSON Pointer] に「/time」を入力します。 { "data": [ {"time": "2025-03-17T09:00:00+09:00", "temperature": 10.5}, {"time": "2025-03-18T09:00:00+09:00", "temperature": 9.4} ] } 一括書き込みについて詳しくは、1 回のデータ送信で複数のデータを書き込む (一括書き込み) を参照してください。
   [送信データの値の形式]	データに含める時刻の形式です。以下のいずれかを選択します。詳しくは、データを Harvest Data に送信する を参照してください。 ISO 8601 形式 UNIX 時間 (秒) UNIX 時間 (ミリ秒)

5. [保存] → [OK] の順にクリックします。

6. IoT SIM、LoRaWAN デバイス、Sigfox デバイスが所属するグループを切り替えます。

   IoT SIM、LoRaWAN デバイス、Sigfox デバイスから送信したデータが Harvest Data に保存できるようになります。

SORACOM CLI / SORACOM API で設定する

SORACOM CLI または SORACOM API を利用しても、送信データの時刻をタイムスタンプとして利用するように指定できます。

• SORACOM CLI を利用する場合は、soracom groups put-config を使用します。
• SORACOM API を利用する場合は、Group:putConfigurationParameters API を使用します。

SORACOM CLI / SORACOM API のリクエストボディで指定するプロパティについて

以下の key と value のペアを配列で指定します。

データを Harvest Data に送信する

「設定を行ったグループに所属する IoT SIM を利用するデバイス」などから Harvest Data にデータを送信します。[送信データの値の形式] で選択した項目によって、解釈できる時刻の形式が異なります。

1. [送信データの時刻をタイムスタンプに利用する] を以下のように設定します。

   設定について詳しくは、ユーザーコンソールで設定する を参照してください。

   • [送信データ形式]: 「JSON」
   • [時刻への JSON Pointer]: /time
   • [送信データの値の形式]: 「ISO 8601 形式」

2. デバイスで Unified Endpoint にデータを送信します。

   $ curl -v http://uni.soracom.io \
   -H 'content-type: application/json' \
   -d '{
     "temperature": 12.3,
     "humidity": 45.6,
     "time": "2024-09-02T12:34:56.789+09:00"
   }'
   

   Harvest Data にデータが保存されます。

   

$ curl http://uni.soracom.io \
-H 'content-type: application/json' \
-d '{
    "temperature": 12.3,
    "humidity": 45.6,
    "time": "2024-09-02T12:34:56.789"
}'

{"message":"Invalid custom timestamp value in request"}

$ curl http://uni.soracom.io \
-H 'content-type: application/json' \
-d '{
    "temperature": 12.3,
    "humidity": 45.6,
    "time": "1725280496789"
}'

{"message":"Invalid custom timestamp value in request"}

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