主要内容

thingSpeakRead

读取存储在ThingSpeak通道

描述

例子

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

例子

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

例子

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

例子

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

例子

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

例子

全部折叠

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

data = 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分钟的数据,并在表中返回数据。

data = thingSpeakRead (12397“字段”(1、4),“NumMinutes”5,“OutputFormat”“时间表”
data = 11×2时刻表时间戳WindDirectionNorth0Degrees temperature ____________________ __________________________ ____________ 14-May-2020 10:08:34 216 63.2 14-May-2020 10:10:34 139 63 14-May-2020 10:11: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 17714-May-2020 10:15:34 196 63.8 14-May-2020 10:16:34 196 63.8 14-May-2020 10:17:34 175 64

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

(数据、时间戳)= thingSpeakRead (12397)
data = 199.0000 6.1000 18.0000 63.6000 0 30.0500 4.1390 0 timestamp = datetime 14-May-2020 10:20:34

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

(数据、时间戳、channelInfo) = thingSpeakRead(12397年“字段”(1、4),“NumMinutes”5)
data = 316.0000 62.5000 276.0000 62.9000 124.0000 63.0000 283.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 237.0000 64.1000时间戳= 11×1 datetime数组14 - 2020年5月- 2020 10:24:34 14 - 5月- 10:25:34 14 - 2020年5月- 2020 10:26:34 14 - 5月- 10:27:34 14 - 2020年5月——10:28:34 14 - 5 - 202010:29:34 14-May-2020 10:31:34 14-May-2020 10:34:34 14-May-2020 10:31:34 14-May-2020 10:34:34 channelInfo = struct with fields: ChannelID: 12397 Name: 'WeatherStation' Description: 'MathWorks WeatherStation, West Garage, Natick, MA 01760, USA' Latitude: 42.2997 Longitude: -71.3505 Altitude: 60 Created:20 - 2014年5月——17:50:32更新:14 - 2020年5月——10:28:40 LastEntryID: 2852997 FieldDescriptions:{“风向(北= 0度)”的风速(英里/小时)的%湿度温度(F)的“雨(英寸/分钟)”的压力(Hg)“功率(V)的光强度的}FieldIDs: [1 2 3 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的数据,包括时间戳和通道信息。

(数据、时间戳、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 155.0000 83.1000时间戳= 4×1 datetime array 09- august -2018 23:59:17 10- august -2018 00:00:20 10- august -2018 00:01:21 10- august -2018 00:02:22'MathWorks Weather Station, West Garage, Natick, MA 01760, USA' Latitude: 42.2997 Longitude: -71.3505 Altitude: 60 Created: 20-May-2014 17:50:32 Updated: 14-May-2020 10:31:40 LastEntryID: 2853000字段说明:{'风向(北= 0度)' '风速(英里)' '%湿度' '温度(F)' '雨(英寸/分钟)' '压力("Hg)' '功率等级(V)' '光强度'}fieldid: [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个数据点,可以调整您的范围或拨打多个电话。

请注意

你不能使用DateRangeNumDaysNumMinutes

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

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

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

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

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

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

请注意

你不能使用NumDaysDateRangeNumMinutes

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

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

请注意

你不能使用NumMinutesDateRangeNumDays

例子: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选项卡上找到一个通道的Read API键。如果从公共通道读取数据,则不需要Read API密钥。为方便起见,将通道Read API键保存在一个变量中。

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

数据类型:字符

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

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

输出参数

全部折叠

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

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

数据类型:datetime

通道信息,作为结构返回,其字段按表中所示的顺序排列。

描述
ChannelID

通道标识号

的名字

航道名称

描述

频道的描述

纬度

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

经度

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

高度

通道的标高如通道设置中所提供的

创建

通道创建日期Datetime

更新

最后一次更改通道设置的时间

去年EntryID

最近频道更新的条目ID

字段描述

字段名称列表

字段id

启用字段列表

URL

提要数据的URL

更多关于

全部折叠

ThingSpeak

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

另请参阅

功能

介绍了R2019a