thingSpeakRead
读取存储在ThingSpeak通道
语法
描述
在上读取指定公共通道的所有字段的最新数据ThingSpeak.com并以数值类型返回数据。数据
= thingSpeakRead (channelID
)
使用一个或多个指定的其他选项数据
= thingSpeakRead (channelID
,名称=值
)名称=值
对参数。要读取非数字数据,必须指定“OutputFormat”
.
[
还从上的指定通道返回时间戳ThingSpeak.com并且可以包括以前语法中的任何输入参数。数据
,时间戳
] = thingSpeakRead(___)
[
还返回通道信息。数据
,时间戳
,channelInfo
] = thingSpeakRead(___)
例子
从一个通道检索三点数据到一个时间表
读取公共通道字段1和字段4中的最后三点数据,并将数据返回到时间表中。
数据= 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?'
输入参数
channelID
- - - - - -通道识别号
数字
通道标识号,指定为正整数。对于私有通道,还必须指定ReadKey
论点。
数据类型:双
名称-值参数
指定可选参数对为Name1 = Value1,…,以=家
,在那里的名字
参数名称和价值
对应的值。名称-值参数必须出现在其他参数之后,但对的顺序无关紧要。
在R2021a之前,使用逗号分隔每个名称和值,并将其括起来的名字
在报价。
例子:位置= true thingSpeakRead (12397);
thingSpeakRead(12397年,“位置”,真正的);
DateRange
- - - - - -收集数据的时间范围
datetime向量
所收集数据返回的时间范围,指定为由“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
- - - - - -数据的天数
正数值标量
要从中提取数据的天数,指定为名称-值对,由“NumDays”
和一个数值。天数以24小时为单位。ThingSpeak服务器将返回的分数限制在8000分以内。调整你的天数,如果你需要超过8000点的数据,可以拨打多个电话。
请注意
你不能使用NumDays
与DateRange
或NumMinutes
.
例子:thingSpeakRead(12397年,NumDays = 2);
NumMinutes
- - - - - -数据分钟数
正数值标量
要从中提取数据的分钟数,指定为由“NumMinutes”
和一个数值。要检索的数据的分钟数是从发出命令时开始测量的。ThingSpeak服务器将返回的分数限制在8000分以内。调整您的分钟数,如果您需要超过8000点的数据,可以拨打多个电话。
请注意
你不能使用NumMinutes
与DateRange
或NumDays
.
例子:thingSpeakRead(12397年,NumMinutes = 20);
数据类型:双
NumPoints
- - - - - -数据点数量
正数值标量
要提取的数据点数,指定为由“NumPoints”
和一个数值。从发出命令时开始计算数据的点或行数。ThingSpeak服务器将返回的分数限制在8000分以内。
例子:thingSpeakRead(12397年,NumPoints = 200);
OutputFormat
- - - - - -输出数据的类
矩阵(默认)|表格|时间表
类的输出数据,指定为逗号分隔的对,由“OutputFormat”
和一个文本值。有效值为“矩阵”
,“表”
,“时间表”
.使用“矩阵”
数值数据的格式。你可以使用“时间表”
或“表”
对于任何非数值数据。的“表”
格式输出(数据、channelInfo)
,在那里数据
包含时间戳和来自通道字段的数据。的“时间表”
格式输出(数据、channelInfo)
,在那里数据
是一个时间表,并包含许多变量的数量要求“字段”
.
例子:thingSpeakRead(12397年,OutputFormat =“表”);
例子:thingSpeakRead(12397年,OutputFormat =“时间表”);
ReadKey
- - - - - -读取通道的API键
API Key的字符向量|string API Key的标量
读取通道的API键,指定为由“ReadKey”
以及表示通道读取API键的字符向量。Read API键允许您从私有通道读取数据。您可以在ThingSpeak通道视图的API Keys选项卡上找到通道的读取API键。如果从公共通道读取数据,则不需要Read API密钥。为方便起见,将通道读取API键保存在变量中。
例子:thingSpeakRead(12397年,ReadKey = ' F6CSCVKX42WFZN9Y ');
数据类型:字符
超时
- - - - - -服务器连接超时时间
10(默认)|正数值标量
服务器连接超时时间,指定为由“超时”
和一个数值。取值为允许的秒数thingSpeakRead
连接到服务器。
例子:thingSpeakRead(12397年,超时= 15);
输出参数
数据
—通道数据
数组(默认)|表|时间表
来自通道的数据,作为数组、表或时间表返回。
时间戳
—每个数据元素的时间戳
数组(默认)
的数组返回的每个数据元素的时间戳datetime
值。
数据类型:datetime
channelInfo
-渠道信息
结构
通道信息,以结构形式返回,字段顺序如表所示。
场 | 描述 |
---|---|
ChannelID |
通道识别号 |
的名字 |
通道名称 |
描述 |
频道的描述 |
纬度 |
频道设置中提供的频道纬度 |
经度 |
频道设置中提供的频道的经度 |
高度 |
通道设置中提供的通道仰角 |
创建 |
Datetime通道创建日期 |
更新 |
上次更改通道设置的日期时间 |
去年EntryID |
最近频道更新的条目ID |
字段描述 |
字段名列表 |
字段id |
启用字段列表 |
URL |
提要数据的URL |
更多关于
ThingSpeak
ThingSpeak是一个物联网分析平台服务,允许您在云中聚合、可视化和分析实时数据流。看到许可选项和商业用途获取更多信息。
版本历史
在R2019a中引入
第一MATLAB
海脂循环匹配函数对应求解MATLAB:
Esegui il commanmando inserendolo nella finestra di commanmando MATLAB。我的浏览器web不支持和MATLAB金宝app。
您也可以从以下列表中选择一个网站:
如何获得最佳的网站性能
选择中国站点(中文或英文)以获得最佳站点性能。其他MathWorks国家站点没有针对您所在位置的访问进行优化。