主要内容

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，名称,值）使用一个或多个指定的其他选项的名字，价值对参数。若要读取非数字数据，必须指定OutputFormat”。

例子

数据= thingSpeakRead (＿＿＿”,ReadKey'，'通道读取API密钥')使用ThingSpeak™读取API密钥从私有通道读取。

例子

［数据，时间戳] = thingSpeakRead(＿＿＿）还从上的指定通道返回时间戳ThingSpeak.com并且可以包括以前语法中的任何输入参数。

例子

［数据，时间戳，channelInfo] = thingSpeakRead(＿＿＿）还返回通道信息。

例子

全部折叠

读取公共通道字段1和字段4中的最后三点数据，并将数据返回到时间表中。

数据= thingSpeakRead(12397，“字段”(1、4),“NumPoints”3,“OutputFormat”，“时间表”）
data = 3×2时间表时间戳WindDirectionNorth0Degrees TemperatureF  ____________________ __________________________ ____________ 14 - 64年5月- 2020年10:17:34 175 14 - 223年5月- 2020年10:18:34 64.3 14 - 211年5月- 2020年10:19:34 64.1

从公共通道的字段1和字段4中读取最近5分钟的数据，并将数据返回到一个表中。

数据= thingSpeakRead(12397，“字段”(1、4),“NumMinutes”5,“OutputFormat”，“时间表”）
data = 11×2 schedule Timestamps WindDirectionNorth0Degrees TemperatureF ____________________ __________________________ ____________ 14-May-2020 10:08:34 216 63.2 14-May-2020 10:09:34 183 62.9 14-May-2020 10:10:34 139 63 14-May-2020 10:13:34 179 62.9 14-May-2020 10:12:34 225 62.9 14-May-2020 10:13:34 250 63 14-May-2020 10:14:34 177 63.2 14-May-2020 10:15:34 196 63.8 14-May-2020 10:16:34 196 63.8 14-May-2020 10:18:34 175 64 14-May-2020 10:18:34 223 64.3

读取公共通道所有字段的最新结果，包括时间戳。

[data,timestamps] = thingSpeakRead(12397)
data = 199.0000 6.1000 18.0000 63.6000 0 30.0500 4.1390 0 timestamps = datetime 14-May-2020 10:20:34

从公共通道字段1和字段4中读取最近5分钟的数据，包括时间戳和通道信息。

[data,timestamps,channelInfo] = thingSpeakRead(12397，“字段”(1、4),“NumMinutes”5)
data = 316.0000 62.5000 276.0000 63.6000 94.0000 63.8000 285.0000 64.1000 233.0000 64.1000 269.0000 64.0000 255.0000 63.8000 203.0000 64.0000 64.1000ChannelID: 12397名称:“气象站”描述:“MathWorks气象站，西车库，纳蒂克，MA 01760，美国”纬度:42.2997经度:-71.3505海拔:60创建:2014年5月20日17:50:32更新:2020年5月14日10:28:40 LastEntryID: 2852997字段说明:{'风向(北= 0度)' '风速(英里)' '%湿度' '温度(F)' '雨(英寸/分钟)' '压力(“汞柱”)' '功率水平(V)' '光强度'}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，“字段”(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,…,的家．

例子: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]);

指示器显示来自通道的数据的位置信息，指定为逗号分隔的对，由“位置”和一个逻辑值。位置信息包括纬度、经度和海拔高度。

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

要从中提取数据的天数，指定为逗号分隔的对，由“NumDays”和一个数值。天数以24小时为单位。ThingSpeak服务器将返回的分数限制在8000分以内。调整你的天数，如果你需要超过8000点的数据，可以拨打多个电话。

请注意

你不能使用NumDays与DateRange或NumMinutes．

例子:thingSpeakRead (12397 ' NumDays ', 2);

要从中提取数据的分钟数，指定为逗号分隔的对，由“NumMinutes”和一个数值。要检索的数据的分钟数是从发出命令时开始测量的。ThingSpeak服务器将返回的分数限制在8000分以内。调整您的分钟数，如果您需要超过8000点的数据，可以拨打多个电话。

请注意

你不能使用NumMinutes与DateRange或NumDays．

例子:thingSpeakRead(12397年,20岁的“NumMinutes”);

数据类型:双

要提取的数据点数，指定为逗号分隔的对，由“NumPoints”和一个数值。从发出命令时开始计算数据的点或行数。ThingSpeak服务器将返回的分数限制在8000分以内。

例子:thingSpeakRead (12397, NumPoints, 200);

类的输出数据，指定为逗号分隔的对，由“OutputFormat”和一个文本值。有效值为“矩阵”，“表”,“时间表”．使用“矩阵”数值数据的格式。你可以使用“时间表”或“表”对于任何非数值数据。的“表”格式输出(数据、channelInfo),在那里数据包含时间戳和来自通道字段的数据。的“时间表”格式输出(数据、channelInfo),在那里数据是一个时间表，并包含许多变量的数量要求“字段”．

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

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

通道的读取API键，指定为由逗号分隔的对组成“ReadKey”以及表示通道读取API键的字符向量。Read API键允许您从私有通道读取数据。您可以在ThingSpeak通道视图的API Keys选项卡上找到通道的读取API键。如果从公共通道读取数据，则不需要Read API密钥。为方便起见，将通道读取API键保存在变量中。

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

数据类型:字符

服务器连接超时时间，指定为逗号分隔的对，由“超时”和一个数值。取值为允许的秒数thingSpeakRead连接到服务器。

例子:thingSpeakRead(12397年,“超时”,15);

输出参数

全部折叠

来自通道的数据，作为数组、表或时间表返回。

的数组返回的每个数据元素的时间戳datetime值。

数据类型:datetime

通道信息，以结构形式返回，字段顺序如表所示。

场 描述
ChannelID

通道识别号
的名字

通道名称
描述

频道的描述
纬度

频道设置中提供的频道纬度
经度

频道设置中提供的频道的经度
高度

通道设置中提供的通道仰角
创建

Datetime通道创建日期
更新

上次更改通道设置的日期时间
去年EntryID

最近频道更新的条目ID
字段描述

字段名列表
字段id

启用字段列表
URL

提要数据的URL

更多关于

全部折叠

ThingSpeak

ThingSpeak是一个物联网分析平台服务，允许您在云中聚合、可视化和分析实时数据流。看到许可选项和商业用途获取更多信息。

另请参阅

功能

在R2019a中引入

MATLAB的文档

金宝app

用MATLAB介绍深度学习

用MATLAB介绍深度学习

下载电子书