说话

读取存储在说话频道

描述

例子

数据= thingSpeakRead (channelID从上指定的公共频道的所有字段读取最新数据ThingSpeak.com并以数字类型返回数据。

例子

数据= thingSpeakRead (channelID名称、值使用一个或多个指定的附加选项的名字价值对参数。若要读取非数字数据,必须指定'输出格式’.

例子

数据= thingSpeakRead (___,'读键“,”通道读取API密钥“)使用ThingSpeak™ 读取API密钥以从专用通道读取。

例子

数据时间戳) = thingSpeakRead (___还返回上指定通道的时间戳ThingSpeak.com并且可以包含前面语法中的任何输入参数。

例子

数据时间戳channelInfo) = thingSpeakRead (___还返回频道信息。

例子

全部崩溃

从公共通道的字段1和4检索最后5分钟的数据,并以时间表返回数据。

data = thingSpeakRead (12397“田地”(1、4),“NumPoints”3.“OutputFormat”“时间表”
数据=3×2时刻表时间戳风向北方0度温度

从公共频道的字段1和字段4读取最后五分钟的数据,并在表格中返回数据。

data = thingSpeakRead (12397“田地”(1、4),“Numminutes”5.“OutputFormat”“时间表”

检索公共通道所有字段的最新结果,包括时间戳。

(数据、时间戳)= thingSpeakRead (12397)

从公共通道的字段1和字段4检索最后5分钟的数据,包括时间戳和通道信息。

(数据、时间戳、channelInfo) = thingSpeakRead(12397年“田地”(1、4),“NumMinutes”,5)

从2018年8月9日11:59:01到2018年8月10日12:02:52检索公共频道字段1和4的数据,包括时间戳和频道信息。

(数据、时间戳、channelInfo) = thingSpeakRead(12397年“田地”(1 - 4),“日期范围”,[日期时间(2018,8,9,23,59,01),日期时间(2018,8,10,0,02,52)])

输入参数

全部崩溃

信道标识号,指定为正整数。对于专用频道,还必须指定'读键”他说。

数据类型:双重的

名称-值对参数

指定可选的逗号分隔的对名称、值论据。的名字参数名和价值是对应的值。的名字必须出现在引号内。您可以按任意顺序指定多个名称和值对参数,如下所示:名称1,值1,…,名称,值

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

要返回的数据范围,指定为逗号分隔对,由“日期范围”和一个值数组[startdate可以,enddate]在MATLAB中®日期时间值。ThingSpeak服务器限制返回的点数最多为8000。如果您需要超过8000个数据点,可以调整您的范围或拨打多个电话。

请注意

你不能使用日期范围星期日NumMinutes

例子:thingSpeakRead(12397,'DateRange',[datetime(' 8月8日,2014'),datetime(' 8月12日,2014')]);

通道字段id,指定为逗号分隔的对,由“田地”以及用于检索数据的通道字段ID的数值。

例子:thingSpeakRead(12397年,“字段”,[1,3,4]);

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

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

要从中提取数据的数据的天数,指定为逗号分隔的对,其中包括“NumDays”和一个数值。天数以24小时为周期计算。ThingSpeak服务器限制返回的点数最多为8000。调整您的天数,或拨打多个电话,如果您需要超过8000个数据点。

请注意

你不能使用星期日日期范围NumMinutes

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

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

请注意

你不能使用NumMinutes日期范围星期日

例子:thingSpeakRead(12397,'NumMinutes',20);

数据类型:双重的

要提取的数据点的数目,以逗号分隔的对指定,包括“NumPoints”和一个数值。从发出命令的时间开始计算数据的点或行数。ThingSpeak服务器限制返回的点数最多为8000。

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

输出数据的类,指定为逗号分隔对,由“OutputFormat”和一个文本值。有效的值“矩阵”“桌子”“时间表”.使用“矩阵”数字数据的格式。你可以用“时间表”“桌子”用于任何非数字数据。的“桌子”格式输出(数据、channelInfo)哪里数据包含时间戳和来自通道字段的数据。的“时间表”格式输出(数据、channelInfo)哪里数据是一个时间表,包含的变量与请求的数量相同“田地”

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

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

读取通道的API密钥,由逗号分隔的对组成“ReadKey”和表示通道读取API密钥的字符向量。读取API密钥允许您从专用通道读取数据。您可以在ThingSpeak通道视图的API密钥选项卡上找到通道的读取API密钥。如果您从公共通道读取数据,则不需要读取API密钥。请将通道读取API密钥保存在变量中,以便方便

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

数据类型:烧焦

服务器连接超时时间,指定为逗号分隔对,由“超时”和一个数值。该值是允许的秒数说话连接到服务器。

例子:thingSpeakRead(12397,'Timeout',15);

输出参数

全部崩溃

通道中的数据,以数组、表或时间表的形式返回。

每个数据元素的时间戳,作为数组返回日期时间值。

数据类型:日期时间

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

描述
渠道

信道识别号

的名字

航道名称

描述

频道描述

纬度

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

经度

在通道设置中提供的通道的经度

高度

通道设置中提供的通道高程

创建

通道创建日期Datetime

更新

上次更改频道设置的日期时间

去年EntryID

最近频道更新的条目ID

字段描述

字段名称列表

字段id

启用字段列表

统一资源定位地址

提要数据的URL

更多关于

全部崩溃

说话

说话是一种物联网分析平台服务,允许您聚合、可视化和分析云中的实时数据流。看到许可证选项商业用途了解更多信息。

另请参阅

功能

介绍了R2019a