このページは機械翻訳を使用して翻訳されました。元の英語を参照するには、ここをクリックします。

thingSpeakRead

ThingSpeakチャネルに保存されているデータを読み取ります

構文

data = thingSpeakRead(channelID)

data = thingSpeakRead(channelID,Name=Value)

data = thingSpeakRead(___,ReadKey='channel Read API key')

[data,timestamps] = thingSpeakRead(___)

[data,timestamps,channelInfo] = thingSpeakRead(___)

説明

data = thingSpeakRead(channelID) は、 ThingSpeak.com上の指定されたパブリックチャネルのすべてのフィールドから最新のデータを読み取り、そのデータを数値型として返します。

data = thingSpeakRead(channelID,Name=Value) は、 1 つ以上のName=Valueペア引数で指定された追加オプションを使用します。数値以外のデータを読み取るには、 'OutputFormat'を指定する必要があります。

data = thingSpeakRead(___,ReadKey='channel Read API key') は、 ThingSpeak™ Read API キーを使用してプライベートチャネルから読み取ります。

[data,timestamps] = thingSpeakRead(___) は、 ThingSpeak.comの指定されたチャネルからのタイムスタンプも返し、前の構文の入力引数のいずれかを含めることができます。

[data,timestamps,channelInfo] = thingSpeakRead(___) はチャネル情報も返します。

例

チャネルから 3 つのポイントのデータを timetable に取得する

パブリックチャネルのフィールド 1 および 4 から最後の 3 ポイントのデータを読み取り、そのデータを timetable に返します。

data = thingSpeakRead(12397,'Fields',[1,4],NumPoints=3,OutputFormat='TimeTable')

data =

  3×2 timetable

         Timestamps         WindDirectionNorth0Degrees    TemperatureF
    ____________________    __________________________    ____________
    18-Nov-2021 13:42:57                34                    70.4    
    18-Nov-2021 13:43:57                50                    70.4    
    18-Nov-2021 13:44:57                54                    70.6

チャネルから 5 分間のデータをタイムテーブルに取得する

パブリックチャネルのフィールド 1 および 4 から最後の 5 分間のデータを読み取り、そのデータをテーブルに返します。

data = thingSpeakRead(12397,Fields=[1,4],NumMinutes=5,OutputFormat='TimeTable')

data =

  11×2 timetable

         Timestamps         WindDirectionNorth0Degrees    TemperatureF
    ____________________    __________________________    ____________

    18-Nov-2021 13:34:57                38                    70.6    
    18-Nov-2021 13:35:57                42                    70.6    
    18-Nov-2021 13:36:57                41                    70.6    
    18-Nov-2021 13:37:57                46                    70.8    
    18-Nov-2021 13:38:57                44                    70.8    
    18-Nov-2021 13:39:57                37                    70.8    
    18-Nov-2021 13:40:57                42                    70.6    
    18-Nov-2021 13:41:57                43                    70.4    
    18-Nov-2021 13:42:57                34                    70.4    
    18-Nov-2021 13:43:57                50                    70.4    
    18-Nov-2021 13:44:57                54                    70.6    
    18-Nov-2021 13:45:57                52                    70.

最近のデータをタイムスタンプとともに取得する

タイムスタンプを含む、パブリックチャネルのすべてのフィールドの最新の結果を読み取ります。

[data,timestamps] = thingSpeakRead(12397)

data =
   52.0000    7.6000   58.0000   70.8000         0   29.6700    4.1360         0


timestamps = 

  datetime

   18-Nov-2021 13:45:57

タイムスタンプとチャネル情報を含む 5 分間のデータを取得

タイムスタンプやチャネル情報を含む、パブリックチャネルのフィールド 1 および 4 から最後の 5 分間のデータを読み取ります。

[data,timestamps,channelInfo] = thingSpeakRead(12397,Fields=[1,4],NumMinutes=5)

data =

   41.0000   70.6000
   46.0000   70.8000
   44.0000   70.8000
   37.0000   70.8000
   42.0000   70.6000
   43.0000   70.4000
   34.0000   70.4000
   50.0000   70.4000
   54.0000   70.6000
   52.0000   70.8000
   39.0000   71.0000


timestamps = 

  11×1 datetime array

   18-Nov-2021 13:36:57
   18-Nov-2021 13:37:57
   18-Nov-2021 13:38:57
   18-Nov-2021 13:39:57
   18-Nov-2021 13:40:57
   18-Nov-2021 13:41:57
   18-Nov-2021 13:42:57
   18-Nov-2021 13:43:57
   18-Nov-2021 13:44:57
   18-Nov-2021 13:45:57
   18-Nov-2021 13:46:57


channelInfo = 

  struct with fields:

            ChannelID: 12397
                 Name: 'WeatherStation'
          Description: 'MathWorks Weather Station, West Garage, Natick, MA 01760, USA'
             Latitude: 42.2997
            Longitude: -71.3505
             Altitude: 60
              Created: 20-May-2014 17:50:32
              Updated: 18-Nov-2021 13:40:31
          LastEntryID: 3638608
    FieldDescriptions: {1×8 cell}
             FieldIDs: [1 2 3 4 5 6 7 8]
                  URL: 'https://api.thingspeak.com/channels/12397/feed.json?'

特定の日付範囲からデータを取得する

タイムスタンプとチャネル情報を含む、パブリックチャネルのフィールド 1 および 4 のデータを、2018 年 8 月 9 日の 11:59:01 から 2018 年 8 月 10 日の 12:02:52 まで読み取ります。

[data,timestamps,channelInfo] = thingSpeakRead(12397,Fields=[1 4],...
    DateRange=[datetime(2018,8,9,23,59,01),datetime(2018,8,10,0,02,52)])

data =

  202.0000   83.3000
  184.0000   83.2000
  185.0000   83.1000
  155.0000   83.1000


timestamps = 

  4×1 datetime array

   09-Aug-2018 23:59:17
   10-Aug-2018 00:00:20
   10-Aug-2018 00:01:21
   10-Aug-2018 00:02:22


channelInfo = 

  struct with fields:

            ChannelID: 12397
                 Name: 'WeatherStation'
          Description: 'MathWorks Weather Station, West Garage, Natick, MA 01760, USA'
             Latitude: 42.2997
            Longitude: -71.3505
             Altitude: 60
              Created: 20-May-2014 17:50:32
              Updated: 14-May-2020 10:31:40
          LastEntryID: 2853000
    FieldDescriptions: {'Wind Direction (North = 0 degrees)'  'Wind Speed (mph)'  '% Humidity'  'Temperature (F)'  'Rain (Inches/minute)'  'Pressure ("Hg)'  'Power Level (V)'  'Light Intensity'}
             FieldIDs: [1 2 3 4 5 6 7 8]
                  URL: 'https://api.thingspeak.com/channels/12397/feed.json?'

入力引数

channelID — チャネル識別番号

数値

チャネル識別番号。正の整数として指定します。プライベートチャネルの場合は、 ReadKey引数も指定する必要があります。

データ型: double

名前と値の引数

オプションの引数のペアをName1=Value1,...,NameN=ValueNとして指定します。ここで、 Nameは引数名、 Value は対応する値です。名前と値の引数は他の引数の後に指定する必要がありますが、ペアの順序は重要ではありません。

« R2021a より前は、各名前と値をカンマで区切って、» Name «引用符で囲みます。»

例: thingSpeakRead(12397,Location=true); thingSpeakRead(12397,'Location',true);

DateRange — 収集されたデータの時間範囲

日時ベクトル

収集されたデータが返される時間の範囲。TG 'DateRange'と、 MATLAB^®に[startdate,enddate]を含む値の配列で構成される名前と値のペアとして指定します。 $ datetime (MATLAB)の値。ThingSpeakサーバーは、返されるポイント数を最大 8000 に制限しています。8000 点を超えるデータが必要な場合は、範囲を調整するか、複数の呼び出しを行います。

メモ

DateRangeをNumDaysまたはNumMinutes と一緒に使用することはできません。

例: thingSpeakRead(12397,DateRange=[datetime('Aug 8, 2014'),datetime('Aug 12, 2014')]);

Fields — チャネルのフィールド

正の数値スカラー

チャネルフィールド ID。TG Fieldsとデータを取得するチャネルフィールド ID の数値で構成される名前と値のペアとして指定します。

例: thingSpeakRead(12397,Fields=[1,3,4]);

Location — データの位置情報

logical 値

チャネルからのデータの位置情報を表示するインジケーター。 Locationと論理値で構成される名前と値のペアとして指定します。位置情報には緯度、経度、高度が含まれます。

例: thingSpeakRead(12397,Location=true);

NumDays — データの日数

正の数値スカラー

データを抽出するデータの日数。TG 'NumDays'と数値で構成される名前と値のペアとして指定します。日数は 24 時間の期間で測定されます。ThingSpeakサーバーは、返されるポイント数を最大 8000 に制限します。8000 点を超えるデータが必要な場合は、日数を調整するか、複数の呼び出しを行います。

メモ

NumDaysをDateRangeまたはNumMinutes と一緒に使用することはできません。

例: thingSpeakRead(12397,NumDays=2);

NumMinutes — データの分数

正の数値スカラー

データを抽出するデータの分数。TG 'NumMinutes'と数値で構成される名前と値のペアとして指定します。取得するデータの分数はコマンドが発行された時点から測定されます。ThingSpeakサーバーは、返されるポイント数を最大 8000 に制限します。8000 点を超えるデータが必要な場合は、分数を調整するか、複数の呼び出しを行います。

メモ

NumMinutesをDateRangeまたはNumDays と一緒に使用することはできません。

例: thingSpeakRead(12397,NumMinutes=20);

データ型: double

NumPoints — データ点数

正の数値スカラー

抽出するデータポイントの数。TG 'NumPoints'と数値で構成される名前と値のペアとして指定します。データの点または行の数はコマンドが発行された時点からカウントされます。ThingSpeakサーバーは、返されるポイント数を最大 8000 に制限します。

例: thingSpeakRead(12397,NumPoints=200);

OutputFormat — 出力データのクラス

行列 (既定値) | table | timetable

出力データのクラス'OutputFormat'とテキスト値で構成されるコンマ区切りのペアとして指定します。有効な値は、 'matrix'、 'table'、および'timetable'です。数値データには'matrix'形式を使用します。数値以外のデータには'timetable'または'table'を使用できます。'table'形式は[data,channelInfo]を出力します。ここで、 dataにはチャネルのフィールドからのタイムスタンプとデータが含まれます。'timetable'形式は[data,channelInfo]を出力します。ここで、 dataはタイムテーブルであり、要求された'fields'の数と同じ数の変数が含まれています。 $$。

例: thingSpeakRead(12397,OutputFormat='table');

例: thingSpeakRead(12397,OutputFormat='timetable');

ReadKey — チャネルの Read API キー

API キーの文字ベクトル | API キーの文字列スカラー

チャネルの読み取り API キー。 'ReadKey'とチャネル読み取り API キーを表す文字ベクトルで構成される名前と値のペアとして指定します。Read API キーにより、プライベート チャネルからデータを読み取ることができます。チャネルの Read API キーは、 ThingSpeakチャネルビューの [API キー] タブで見つけることができます。公開チャネルからデータを読み取る場合、Read API キーは必要ありません。便宜上、チャネル読み取り API キーを変数に保存します。

例: thingSpeakRead(12397,ReadKey='F6CSCVKX42WFZN9Y');

データ型: char

Timeout — サーバー接続タイムアウト期間

10 (既定値) | 正の数値スカラー

サーバー接続のタイムアウト期間。TG 'Timeout'と数値で構成される名前と値のペアとして指定します。値は、thingSpeakReadがサーバーに接続するために許可される秒数です。

例: thingSpeakRead(12397,Timeout=15);

出力引数

data — チャネルからのデータ

配列 (既定値) | table | timetable

チャネルからのデータ。配列、table、または timetable として返されます。

timestamps — 各データ要素のタイムスタンプ

配列 (既定値)

各データ要素のタイムスタンプdatetime値の配列として返されます。

データ型: datetime

channelInfo — チャネル情報

構造体

チャネル情報。表に示されている順序でフィールドを持つ構造体として返されます。

分野	説明
ChannelID	チャネル識別番号
Name	チャネル名
Description	チャネルの説明
Latitude	チャネル設定で指定されたチャネルの緯度
Longitude	チャネル設定で指定されたチャネルの経度
Altitude	チャネル設定で指定されたチャネルの標高
Created	チャネル作成日の日時
Updated	チャネル設定が最後に変更された日時
Last EntryID	最新のチャネル更新のエントリ ID
Field Descriptions	フィールド名のリスト
Field IDs	有効なフィールドのリスト
URL	フィードデータのURL

詳細

ThingSpeak

ThingSpeak は、クラウド内のライブ データ ストリームを集約、視覚化、分析できる IoT 分析プラットフォーム サービスです。詳細については、License OptionsおよびCommercial Use を参照してください。

バージョン履歴

R2019a で導入

参考

関数

• thingSpeakWrite | webread (MATLAB)