主要内容

thingSpeakRead

读取数据存储在ThingSpeak通道

自从R2019a

所有的页面崩溃

语法

data = thingSpeakRead (channelID)
data = thingSpeakRead (channelID Name =值)
数据= thingSpeakRead (___ReadKey =频道阅读API密匙)
(数据、时间戳)= thingSpeakRead (___)
(数据、时间戳、channelInfo) = thingSpeakRead (___)

描述

例子

数据= thingSpeakRead (channelID)从所有字段中读取最新数据的指定的公共通道ThingSpeak.com并返回数据作为数字类型。

例子

数据= thingSpeakRead (channelID,名称=值)使用指定的一个或多个额外的选项名称=值对参数。读取非数字数据,你必须指定“OutputFormat”。

例子

数据= thingSpeakRead (___,ReadKey= '频道阅读API键”)使用ThingSpeak™API密匙读阅读从一个私人频道。

例子

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

例子

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

例子

全部折叠

读取的数据字段的最后3分1和4的公共频道,并返回数据到一个时间表。

data = 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的公共频道,并返回数据导入表中。

data = thingSpeakRead(12397字段= [1,4],NumMinutes = 5, OutputFormat =“时间表”)
data = 11×2时间表时间戳WindDirectionNorth0Degrees TemperatureF ____________________ __________________________ _______ 11月18 - 38 - 2021 13:34:57 70.6 - 2021年11月18 - 13:35:57 42 11月18 - 70.6 - 70.6 2021 13:36:57 41 - 2021年11月18 - 70.8 13:37:57 46 - 2021年11月18 - 70.8 13:38:57 44 - 2021年11月18 - 70.8 13:39:57 37 - 2021年11月18 - 70.6 13:40:57 42 - 2021年11月18 - 43 13:41:57 70.4 - 2021 13:42:57 11月18 - 34岁70.4 - 2021年11月18 - 70.4 13:43:57 50 - 2021年11月18 - 13:44:57 54 70.6 18 - 70年11月- 2021 13:45:57 52。

阅读最新的结果对所有领域的公共频道,包括时间戳。

(数据、时间戳)= thingSpeakRead (12397)
data = 52.0000 7.6000 58.0000 70.8000 29.6700 - 4.1360 0时间戳= datetime 11月18 - - 2021 13:45:57

读数据字段的最后五分钟1和4的公共频道,包括时间戳和频道信息。

(数据、时间戳、channelInfo) = thingSpeakRead(12397年,字段= [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姓名:WeatherStation的描述:“马MathWorks气象站、西车库,纳蒂克,01760年,美国的纬度:42.2997经度:-71.3505高度:60:创建20 - 2014年5月——17:50:32更新:11月18 - - 2021 13:40:31 LastEntryID: 3638608 FieldDescriptions:{1×8细胞}FieldIDs: [1 2 3 4 5 6 7 8] URL: https://api.thingspeak.com/channels/12397/feed.json?的

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

(数据、时间戳、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 83.1000 155.0000 83.1000时间戳= 4×1 datetime数组09 - 2018年8月- 2018年8月23:59:17 10 - - 00:00:20 10 - 8月- 2018年00:01:21 10 - 8月- 2018年00:02:22 channelInfo =结构体字段:ChannelID: 12397姓名:WeatherStation的描述:“马MathWorks气象站、西车库,纳蒂克,01760年,美国的纬度:42.2997经度:-71.3505高度:60:创建20 - 2014年5月——17:50:32更新:14 - 2020年5月——10:31:40 LastEntryID: 2853000 FieldDescriptions:{风向(北= 0度)的风速(英里/小时)的‘%湿度温度(F)的“雨(英寸/分钟)”的压力(Hg)“功率(V)的光强度的}FieldIDs: [1 2 3 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(2014年8月8日),datetime(2014年8月12日)]);

通道字段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密钥标签视图。如果你是读取数据从公共频道,你不需要阅读API键。保存您的频道阅读API密匙在一个变量中为了方便。

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

数据类型:字符

服务器连接超时时间,指定为一个名称-值对组成“超时”和一个数字值。值是允许的秒数thingSpeakRead连接到服务器。

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

输出参数

全部折叠

的数据通道,作为一个数组,返回表,或时间表。

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

数据类型:datetime

通道信息,作为结构返回表中字段的顺序显示。

场 描述
ChannelID

通道标识号
的名字

通道的名称
描述

频道的描述
纬度

纬度的通道提供的通道设置
经度

经度的通道提供的通道设置
高度

海拔高度通道提供的通道的设置
创建

Datetime的通道创建日期
更新

Datetime通道设置在去年发生了变化
去年EntryID

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

字段名称列表
字段id

启用字段列表
URL

包数据的URL

更多关于

全部折叠

ThingSpeak

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

版本历史

介绍了R2019a

另请参阅

功能