Soracom

Users

スタートガイド

ボタンクリック時のデータを SORACOM Harvest Data で確認する

Enterprise ボタンのボタンをクリックしたときに、クリック種別、バッテリ残量などのデータを SORACOM Harvest (SORACOM Harvest Data) に保存できます。

SORACOM Harvest Data の利用料金が発生します
SORACOM Harvest Data の利用には料金が発生します。詳細は 料金プラン を参照してください。
SORACOM LTE-M Button Plus でも、同様に設定すると、ボタンクリック時に SORACOM Harvest Data にデータを保存できます。

準備 

あらかじめ、ユーザーコンソールに SORACOM LTE-M Button for Enterprise を登録 してください。

ステップ 1: 可視化を有効にする 

  1. SORACOM ユーザーコンソール にアクセスし、[Menu][ガジェット管理][LTE-M Button for Enterprise] の順にクリックします。

    LTE-M Button for Enterprise 管理画面が表示されます。

  2. 可視化を有効にする Enterprise ボタンにチェックを入れ、[デバイス設定変更] をクリックします。

  3. [可視化を有効にする (SORACOM Harvest Data / Lagoon)] にチェックを入れ、画面下部までスクロールして [保存][デバイス一覧に戻る] の順にクリックします。

    LTE-M Button for Enterprise 管理画面に戻ります。

ステップ 2: ボタンをクリックして Harvest Data へのデータ保存を確認する 

  1. ボタンをシングルクリックします。

    LED が約 10 秒間オレンジで点滅したあと、約 3 秒間緑色に点灯します。

    緑色に点灯しない場合は
    • 約 5 秒間赤色に点灯した場合は、基地局との接続に失敗しています。電波状況の良いところで再度試してください。
    • 約 5 秒間赤色に点滅した場合は、電池残量が不足しています。電池を交換してください。
  2. 緑色に点灯した場合は、LTE-M Button for Enterprise 管理画面 で対象の Enterprise ボタンにチェックを入れ、[SORACOM Harvest Data] をクリックします。

    Harvest Data に保存されているデータが表示されます。

    特に、[グラフ用データ] の以下のデータを確認してください。

    データ説明
    clickTypeクリックの 3 つのタイプ (数値)。
    1: シングルクリック、2: ダブルクリック、3: 長押し のいずれか
    clickTypeNameクリックの 3 つのタイプ (文字列)。
    SINGLE: シングルクリック、DOUBLE: ダブルクリック、LONG: 長押し のいずれか
    batteryLevelバッテリーレベル。
    0.250.50.751.0 の四段階
    binaryParserEnabledバイナリパーサー の有効/無効。
    true: 有効、false: 無効
    $metadata.location.lat緯度 (簡易位置測位機能を有効にした場合)。
    -90 ~ 90
    $metadata.location.lon経度 (簡易位置測位機能を有効にした場合)。
    -180 ~ 180
SORACOM Harvest Data のデフォルトのデータ保持期間は 40 日間です。
  • SORACOM Harvest Data の表示をグラフ表示に切り替えると、batteryLevel の変化を見ることができます。なお、clickTypeName など一部のデータはグラフに表示されません。
  • $metadata.location.lat および $metadata.location.lon は、[データ] には保存されません。また、[一次処理済みデータ] では、以下のようにネストされた JSON 形式で保存されます。
    {
      "clickType": 1,
      "clickTypeName": "SINGLE",
      "batteryLevel": 1,
      "binaryParserEnabled": true,
      "$metadata": {
        "locationQueryResult": "success",
        "location": {
          "lat": 35.6697898,
          "lon": 139.744167845935
        }
      }
    }
    

ステップ 3: (任意) 位置情報を保存する 

簡易位置測位機能を有効にすると、$metadata.location.lat および $metadata.location.lon も SORACOM Harvest Data に保存されます。

  • 簡易位置測位機能は、ボタンをシングルクリック、ダブルクリック、長押ししたときの Enterprise ボタンの位置が 1 回だけ送信される機能です。Enterprise ボタンが移動した経路を取得するには、定期的にボタンを操作してください。
  • 簡易位置測位機能の利用には料金が発生します。詳しくは、特定地域向け IoT SIM のご利用料金 を参照してください。
  1. LTE-M Button for Enterprise 管理画面 を表示します。

  2. 位置情報を送信する Enterprise ボタンにチェックを入れ、[デバイス設定変更] をクリックします。

  3. [位置情報を付与する (簡易位置測位機能)] にチェックを入れ、[保存][デバイス一覧に戻る] の順にクリックします。

  4. ステップ 2: ボタンをクリックして Harvest Data へのデータ保存を確認する の手順を行い、SORACOM Harvest Data に保存されているデータを表示します。

  5. Map ([Map]) をクリックします。

    地図表示に切り替わります。Enterprise ボタンのおおよその位置が表示されることを確認してください。

Harvest Data では位置情報は一次処理済みデータおよびグラフ用データに含まれます
簡易位置測位機能のデータフォーマットは、送信に利用するサービスによって異なります。詳しくは、簡易位置測位機能のデータフォーマット を参照してください。