主要内容

thingSpeakRead

ThingSpeakチャネルに格納されたデ，タの読み取り

ペ，ジ内をすべて折りたたむ

構文

数据= thingSpeakRead(channelID)
data = thingSpeakRead(channelID,Name=Value)
数据= thingSpeakRead(___，ReadKey='通道读取API密钥')
[data,timestamps] = thingSpeakRead(___）
[data,timestamps,channelInfo] = thingSpeakRead(___）

説明

例

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

例

数据= thingSpeakRead (channelID，名称=值）は，1以上の名称=值のペアの引数によって指定された追加オプションを使用します。非数値デ，タを読み取るには，“OutputFormat”を指定しなければなりません。

例

数据= thingSpeakRead (___，ReadKey='通道读取API密钥')は,ThingSpeak™のAPI読み取りキーを使用してプライベートチャネルから読み取ります。

例

［数据，时间戳] = thingSpeakRead(___）は,ThingSpeak.comの指定されたチャネルからタ@ @ムスタンプも返します。前述の構文の任意の入力引数を含めることができます。

例

［数据，时间戳，channelInfo] = thingSpeakRead(___）は，チャネル情報も返します。

例

すべて折りたたむ

パブリックチャネルのフィールド1と4の過去3つの点のデータを読み取り,时间表の形式でデータを返します。

数据= thingSpeakRead(12397，“字段”[1,4], NumPoints = 3, OutputFormat =“时间表”）
data = 3×2时间表时间戳WindDirectionNorth0Degrees TemperatureF  ____________________ __________________________ ____________ 11月18 - 34 - 2021 13:42:57 70.4 70.4 - 2021 13:43:57 11月18 - 50 - 2021年11月18 - 70.6 13:44:57 54

パブリックチャネルのフィールド1と4の過去5分間のデータを読み取り,表の形式でデータを返します。

data = thingSpeakRead(12397,Fields=[1,4]，NumMinutes=5,OutputFormat=“时间表”）
data = 11×2 schedule时间戳风向北方度温度f ____________________ __________________________ ____________ 18- 11 -2021 13:34:57 38 70.6 18- 11 -2021 13:35:57 42 70.6 18- 11 -2021 13:37:57 46 70.8 18- 11 -2021 13:39:57 44 70.8 18- 11 -2021 13:40:57 42 70.6 18- 11 -2021 13:41:57 43 70.4 18- 11 -2021 13:42:57 34 70.4 18- 11 -2021 13:43:57 54 70.6 18- 11 -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

パブリックチャネルのフィールド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时间戳= 11×1 datetime数组- 2021 13:36:57 11月18 - 18 - 2021年11月- 2021年11月13:37:57 18 - - 13:38:57 18 - 2021年11月- 2021年11月13:39:57 18 - - 13:40:57 18 - 2021年11月- 2021年11月13:41:57 18 - - 13:42:57 18 - 2021年11月- 2021年11月13:43:57 18 - - 13:44:57 18 - 2021年11月- 2021年11月13:45:57 18 - - 13:46:57 channelInfo =结构体字段:ChannelID:12397名称:“气象站”描述:“MathWorks气象站，西车库，纳蒂克，MA 01760，美国”纬度:42.2997经度:-71.3505海拔:60创建:2014年5月20日17:50:32更新:2021年11月18日13:40:31 LastEntryID: 3638608字段描述:{1×8 cell} FieldIDs: [1 23 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 85.0000 155.0000 83.1000 timestamp = 4×1 datetime array 09- 08.2018 23:59:17 10- 08.2018 00:00:20 10- 08.2018 00:01:21 10- 08.2018 00:02:22 channelInfo = struct with fields: ChannelID: 12397名称:'WeatherStation'描述:'MathWorks WeatherStation, West Garage, Natick, MA 01760, USA'纬度:42.2997经度:-71.3505海拔:60创建时间:2014年5月20日17:50:32更新时间:2020年5月14日10:31:40 LastEntryID: 2853000字段说明:{'风向(北= 0度)' '风速(每小时)' '%湿度' '温度(F)' '雨(英寸/分钟)' '压力(“汞柱)' '功率水平(V)' '光强度'}FieldIDs: [1 23 4 5 6 7 8] URL: 'https://api.thingspeak.com/channels/12397/feed.json?'

入力引数

すべて折りたたむ

チャネルの識別番号。正の整数として指定します。プラベトチャネルにいては，ReadKey引数も指定しなければなりません。

デ，タ型:双

名前と値の引数

引数のオプションのペアをName1 = Value1,…,以=家として指定します。ここで的名字は引数名で，价值は対応する値です。名前と値の引数は他の引数の後になければなりませんが、ペアの順序は重要ではありません。

R2021aより前では，コンマを使用してそれぞれの名前と値を区切り，的名字を引用符で囲みます。

例:位置= true thingSpeakRead (12397);thingSpeakRead(12397年,“位置”,真正的);

収集されたデ，タを返す時間範囲。“DateRange”と[startdate可以,enddate]の値(matlab)®のdatetimeの値)の配列で構成される名前と値のペアとして指定します。ThingSpeakサーバーでは、返す点の数が最大 8000 に制限されます。8000 を超えないように範囲を調整するか、それよりも多くの点のデータが必要な場合は呼び出しを複数回に分けて行ってください。

メモ

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

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

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

例:thingSpeakRead(12397年,字段= (1,3,4));

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

例:位置= true thingSpeakRead (12397);

デ，タを抽出する日数。“NumDays”と数値で構成される名前と値のペアとして指定します。日数は24時間周期で測定されます。ThingSpeakサーバーでは、返す点の数が最大 8000 に制限されます。8000 を超えないように日数を調整するか、それよりも多くの点のデータが必要な場合は呼び出しを複数回に分けて行ってください。

メモ

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

例:thingSpeakRead(12397年,NumDays = 2);

デ，タを抽出する分数。“NumMinutes”と数値で構成される名前と値のペアとして指定します。デ，タを取得する分数は，コマンドが発行された時点から測定されます。ThingSpeakサーバーでは、返す点の数が最大 8000 に制限されます。8000 を超えないように分数を調整するか、それよりも多くの点のデータが必要な場合は呼び出しを複数回に分けて行ってください。

メモ

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

例:thingSpeakRead(12397年,NumMinutes = 20);

デ，タ型:双

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

例:thingSpeakRead(12397年,NumPoints = 200);

出力デ，タのクラス。“OutputFormat”とテキスト値で構成されるコンマ区切りのペアとして指定します。有効な値は“矩阵”、“表”，および“时间表”です。数値データには“矩阵”形式を使用します。非数値デ，タには“时间表”または“表”を使用できます。“表”形式で出力される(数据、channelInfo)の数据には，タムスタンプとチャネルのフィルドからのデタが格納されます。“时间表”形式で出力される(数据、channelInfo)の数据には，要求した“字段”と同じ数の変数が时间表の形式で格納されます。

例:thingSpeakRead(12397年,OutputFormat =“表”);

例:thingSpeakRead(12397年,OutputFormat =“时间表”);

チャネルのAPI読み取りキ。“ReadKey”とチャネルのAPI読み取りキ，を表す文字ベクトルで構成される名前と値のペアとして指定します。API読み取りキは，プラベトチャネルからデタを読み取る場合に使用します。チャネルのAPI読み取りキは,ThingSpeakチャネル ビューの [API Keys] タブにあります。パブリック チャネルからデータを読み取る場合は API 読み取りキーは必要ありません。チャネルの API 読み取りキーは変数に保存しておくと便利です。

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

デ，タ型:字符

サバ接続タムアウト期間。“超时”と数値で構成される名前と値のペアとして指定します。thingSpeakReadがサ，バ，への接続を試行できる秒数の値です。

例:thingSpeakRead(12397年,超时= 15);

出力引数

すべて折りたたむ

チャネルからのデ，タ。配列，表格，または时间表として返されます。

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

デ，タ型:datetime

チャネル情報。次の表に示すフィ，ルドをこの順序で格納した構造体として返されます。

フィ，ルド 説明
ChannelID

チャネルの識別番号
的名字

チャネルの名前
描述

チャネルの説明
纬度

チャネルの設定で指定されているチャネルの緯度
经度

チャネルの設定で指定されているチャネルの経度
高度

チャネルの設定で指定されているチャネルの高度
创建

チャネルの作成日時
更新

チャネルの設定の最終更新日時
去年EntryID

最新のチャネル更新のエントリid
字段描述

フィ，ルド名のリスト
字段id

有効になっているフィ，ルドのリスト
URL

フィ，ドデ，タのurl

詳細

すべて折りたたむ

ThingSpeak

ThingSpeakは物联网解析プラットフォームサービスであり,これによってクラウドにあるライブデータストリームの集計,可視化,解析が可能になります。詳細にいては，许可选项および商业用途を参照してください。

バ，ジョン履歴

R2019aで導入

参考

関数