本页对应的英文页面已更新,但尚未翻译。 若要查看最新内容,请点击此处访问英文页面。

thingSpeakRead

读取存储在 ThingSpeak 通道中的数据

说明

示例

data = thingSpeakRead(channelID)ThingSpeak.com 上的指定公共通道的所有字段中读取最新数据,并将数据以数值类型形式返回。

示例

data = thingSpeakRead(channelID,Name,Value) 使用一个或多个 Name,Value 对组参数指定的其他选项。要读取非数值数据,您必须指定 ‘OutputFormat’。

示例

data = thingSpeakRead(___,'ReadKey','channel Read API key') 使用 ThingSpeak™ Read API 密钥从私有通道读取。

示例

[data,timestamps] = thingSpeakRead(___) 还从 ThingSpeak.com 上的指定通道返回时间戳,并且可以包括上述语法中的任何输入参数。

示例

[data,timestamps,channelInfo] = thingSpeakRead(___) 也返回通道信息。

示例

全部折叠

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

data = thingSpeakRead(12397,'Fields',[1,4],'NumPoints',3,'OutputFormat','TimeTable')
data =

  3×2 timetable

         Timestamps         WindDirectionNorth0Degrees    TemperatureF
    ____________________    __________________________    ____________

    15-Jan-2019 08:16:15               129                    26.1    
    15-Jan-2019 08:17:16               115                    26.1    
    15-Jan-2019 08:18:19               133                    26.2    

从一个公共通道的字段 1 和字段 4 中读取最后五分钟的数据,并以表形式返回数据。

data = thingSpeakRead(12397,'Fields',[1,4],'Numminutes',5,'OutputFormat','TimeTable')
data =

  5×2 timetable

         Timestamps         WindDirectionNorth0Degrees    TemperatureF
    ____________________    __________________________    ____________

    13-Nov-2018 09:22:48               117                    53.4    
    13-Nov-2018 09:23:48               110                    53.4    
    13-Nov-2018 09:24:50                90                    53.5    
    13-Nov-2018 09:25:52                95                    53.5    
    13-Nov-2018 09:26:55                90                    53.5    

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

[data,timestamps] = thingSpeakRead(12397)
data =

  Columns 1 through 7

  175.0000    7.5000   45.0000   47.5000         0   29.6000    3.4000

  Column 8

   39.0000


timestamps = 

  datetime

   03-Jan-2019 14:30:36

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

[data,timestamps,channelInfo] = thingSpeakRead(12397,'Fields',[1,4],'NumMinutes',5)
data =

  315.0000   39.7000
  314.0000   39.7000
  314.0000   39.8000
  314.0000   39.9000
  315.0000   39.9000


timestamps = 

  5×1 datetime array

   20-Nov-2018 08:29:39
   20-Nov-2018 08:30:40
   20-Nov-2018 08:31:41
   20-Nov-2018 08:32:41
   20-Nov-2018 08:33:43


channelInfo = 

  struct with fields:

            ChannelID: 12397
                 Name: 'WeatherStation'
          Description: '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: 25-Sep-2018 20:08:42
          LastEntryID: 2132316
    FieldDescriptions: {1×8 cell}
             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 的数据,包括时间戳和通道信息。

[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   83.1000
  155.0000   83.1000


timestamps = 

  4×1 datetime array

   09-Aug-2018 23:59:17
   10-Aug-2018 00:00:20
   10-Aug-2018 00:01:21
   10-Aug-2018 00:02:22


channelInfo = 

  struct with fields:

            ChannelID: 12397
                 Name: 'WeatherStation'
          Description: '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: 25-Sep-2018 20:08:42
          LastEntryID: 2122785
    FieldDescriptions: {1×8 cell}
             FieldIDs: [1 2 3 4 5 6 7 8]
                  URL: 'https://api.thingspeak.com/channels/12397/feed.json?'

输入参数

全部折叠

通道标识号,指定为正整数。对于私有通道,您还必须指定 ‘ReadKey’ 参数。

数据类型: double

名称-值对组参数

指定可选的、以逗号分隔的 Name,Value 对组参数。Name 为参数名称,Value 为对应的值。Name 必须放在引号中。您可采用任意顺序指定多个名称-值对组参数,如 Name1,Value1,...,NameN,ValueN 所示。

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

要返回的数据的范围,指定为逗号分隔的对组,其中包含 'DateRange' 和一个值数组,其中的值在 MATLAB® datetime 值中具有 [startdate,enddate]。ThingSpeak 服务器将返回的点数限制为最多 8000 个。如果您需要超过 8000 个数据点,请调整范围或进行多次调用。

注意

您不能将 DateRangeNumDaysNumMinutes 结合使用。

示例: thingSpeakRead(12397,'DateRange',[datetime('Aug 8, 2014'),datetime('Aug 12, 2014')]);

通道字段 ID,指定为逗号分隔的对组,其中包含 'Fields' 和要从中检索数据的通道字段 ID 的数值。

示例: thingSpeakRead(12397,'Fields',[1,3,4]);

显示来自通道的数据位置信息的指示符,指定为逗号分隔的对组,其中包含 'Location' 和一个逻辑值。位置信息包括纬度、经度和高度。

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

从中提取数据的数据的天数,指定为以逗号分隔的对组,其中包含 'NumDays' 和一个数值。天数以 24 小时为度量单位。ThingSpeak 服务器将返回的点数限制为最多 8000 个。请调整您的天数,如果您需要超过 8000 个数据点,请进行多次调用。

注意

您不能将 NumDaysDateRangeNumMinutes 结合使用。

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

从中提取数据的数据的分钟数,指定为以逗号分隔的对组,其中包含 'NumMinutes' 和一个数值。要检索的数据的分钟数是从发出命令时开始度量的。ThingSpeak 服务器将返回的点数限制为最多 8000 个。请调整您的分钟数,如果您需要超过 8000 个数据点,请进行多次调用。

注意

您不能将 NumMinutesDateRangeNumDays 结合使用。

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

数据类型: double

要提取的数据点的数量,指定为以逗号分隔的对组,其中包含 'NumPoints' 和一个数值。数据点的数量或数据的行数是从发出命令时开始计数的。ThingSpeak 服务器将返回的点数限制为最多 8000 个。

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

输出数据的类,指定为以逗号分隔的对组,其中包含 'OutputFormat' 和一个文本值。有效值为 'matrix''table''timetable'。对数值数据使用 'matrix' 格式。对任何非数值数据可以使用 'timetable''table''table' 格式输出 [data,channelInfo],其中 data 包含来自通道字段的时间戳和数据。'timetable' 格式输出 [data,channelInfo],其中 data 是时间表,包含的变量与请求的 'fields' 的数量一样多。

示例: thingSpeakRead(12397,'OutputFormat','table');

示例: thingSpeakRead(12397,'OutputFormat','timetable');

通道的 Read API 密钥,指定为逗号分隔的对组,其中包含 'ReadKey' 和一个表示通道读取 API 密钥的字符向量。Read API 密钥允许您从私有通道读取数据。如果您正在从公共通道读取数据,则不需要 Read API 密钥。为了方便起见,请将您的通道 Read API 密钥保存在变量中。

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

数据类型: char

服务器连接超时期限,指定为以逗号分隔的对组,其中包含 'Timeout' 和一个数值。该值是 thingSpeakRead 连接到服务器所允许的秒数。

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

输出参数

全部折叠

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

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

数据类型: datetime

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

字段说明
ChannelID

通道标识号

Name

通道的名称

Description

通道说明

Latitude

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

Longitude

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

Altitude

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

Created

通道创建日期的日期时间

Updated

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

Last EntryID

最近通道更新的项 ID

Field Descriptions

字段名称的列表

Field IDs

已启用字段的列表

URL

馈送数据的 URL

详细信息

全部折叠

ThingSpeak

ThingSpeak 是一种物联网分析平台服务,使您能够聚合、可视化和分析云中的实时数据流。有关详细信息,请参阅许可证选项商业用途

另请参阅

函数

在 R2019a 中推出