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. [送信データの時刻をタイムスタンプに利用する] のスイッチをクリックして有効化します。

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

   項目	説明
   [送信データ形式]	Harvest Data に送信するデータ形式です。「JSON」を選択します。
   [時刻への JSON Pointer]	送信データ内の時刻データのあるプロパティを JSON Pointer (RFC 6901) で設定します。 たとえば、"time" のデバイスが以下のような JSON を送信するときは、/time を入力します。 { "temperature": 12.3, "humidity": 45.6, "time": "2024-09-02T12:34:56.789Z" }
   [送信データの値の形式]	データに含める時刻の形式です。以下のいずれかを選択します。詳しくは、データを Harvest Data に送信する を参照してください。 ISO 8601 形式 UNIX 時間 (秒) UNIX 時間 (ミリ秒)

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

5. 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"}