主要内容

thingSpeakWrite

将数据写入ThingSpeak通道

自从R2019a

描述

例子

thingSpeakWrite (channelID数据,“WriteKey”、“通道写API密钥')将数据写入指定的通道。写API键被指定为逗号分隔的对,由“WriteKey”和表示通道写键的字符向量或字符串。

例子

thingSpeakWrite (___名称,值使用一个或多个指定的其他选项名称,值对参数。

例子

响应= thingSpeakWrite (___成功完成写操作后返回ThingSpeak™服务器提供的响应。

例子

全部折叠

将单个数值写入通道的字段1。

thingSpeakWrite》(17504,2.3,“WriteKey”“23 zlgobbu9twhg2h”

将数值写入通道的前四个连续字段[1,2,3,4]。

response = thingSpeakWrite(17504,[2.3,1.2,3.2,0.1],“WriteKey”“23 zlgobbu9twhg2h”

将非数字数据写入通道的前三个连续字段[1,2,3]。

thingSpeakWrite(17504年,{2.3,“上”‘好’},“WriteKey”“23 zlgobbu9twhg2h”

将混合值写入通道的非连续字段[1,4,6]。

thingSpeakWrite (17504“字段”(1, 4, 6),“值”{2.3,“上”‘好’},“WriteKey”“23 zlgobbu9twhg2h”

更新三个字段,并为条目写入纬度、经度和海拔数据。

thingSpeakWrite (17504 (1.1, 2.3, 4),“位置”, -40年,23岁,35岁,“WriteKey”“23 zlgobbu9twhg2h”

将纬度、经度和海拔数据写入通道,而不向字段添加值。

thingSpeakWrite (17504“位置”(3500年-40年,23日),“WriteKey”“23 zlgobbu9twhg2h”

为写入通道的值编写时间戳。提供的时间戳被解释为本地时间。

tStamp =日期时间(“现在”) thingSpeakWrite (17504, (2.3, 1.2, 3.2, 0.1),“WriteKey”“23 zlgobbu9twhg2h”“时间戳”tStamp)

将数据矩阵写入通道的前三个字段。提供的时间戳被解释为本地时间。

%生成随机数据数据= randi(10,10,3);为数据生成时间戳tStamps =日期时间(“现在”(1)分钟(9):分钟):datetime (“现在”);channelID = 17504;%更改您的频道IDwriteKey =“23 zlgobbu9twhg2h”%更改您的写API键为频道的每个字段加上时间戳写入10个值thingSpeakWrite (channelID、数据“时间戳”tStamps,“WriteKey”writeKey)

将数据的时间表写入通道的前两个字段。提供的时间戳被解释为本地时间。

生成随机数据dataField1 = randi(10,10,1);dataField2 = randi(10,10,1);为数据生成时间戳tStamps =[日期时间(“现在”(1)分钟(9):分钟):datetime (“现在”)];%创建时间表dataTable =时间表(tStamps,dataField1,dataField2);channelID = 17504;%更改为您的频道IDwriteKey =“23 zlgobbu9twhg2h”%更改您的写API键为频道的每个字段加上时间戳写入10个值thingSpeakWrite (channelID dataTable,“WriteKey”writeKey)

输入参数

全部折叠

通道标识号,指定为正整数。

要写入通道的数据,指定为数值标量或数值向量、单元格数组、单元格数组字符串、表格或时间表。如果指定标量数据,则将该值写入通道的第一个字段(字段1)。对于向量或一维单元格数组,数据将写入从字段1开始的连续字段。

例子:thingSpeakWrite(17504,{2,3,'on','good'},'WriteKey','channel write api key');

通道的写API密钥,指定为由逗号分隔的对组成“WriteKey”以及表示通道写API键的字符向量。写入API键是将数据写入通道所必需的。您可以在ThingSpeak通道视图的API Keys选项卡上找到通道的Write API键。为方便起见,将通道写API键保存在变量中。

例子:thingSpeakRead (12397 ' WriteKey ', ' XXXXXXXXXXXXXXXX ');

名称-值参数

指定可选参数对为Name1 = Value1,…,以=家,在那里名字参数名称和价值对应的值。名称-值参数必须出现在其他参数之后,但对的顺序无关紧要。

在R2021a之前,使用逗号分隔每个名称和值,并将其括起来名字在报价。

例子:thingSpeakWrite(17504,[1.1,2.2],'Fields',[1,2,3],'WriteKey','channel write api key');

通道字段id,指定为逗号分隔的对,由“字段”一个1 × n的正整数。

例子:thingSpeakWrite(17504,[2.3,1.2,3.2,0.1],'Fields',[1,2,3,4],'WriteKey','channel write api key');

数据值,指定为逗号分隔的对,由“值”数字标量、数字向量、单元格数组、单元格数组字符串、表格或时间表值。属性指定要写入通道字段的数据“字段”参数。

例子:thingSpeakWrite(17504,'字段',[1,3,4],'值',[1,2,3],'WriteKey','通道写入api密钥');

通道中数据的位置信息,指定为逗号分隔的对,由“位置”和数字数组。位置信息包括纬度、经度和海拔高度。这个示例为字段1提供的三个点中的每个点写入相同的位置信息。

例子:thingSpeakWrite(17504(2.3, 1.2, 3.2, 0.1),“位置”,(-40、23200),“WriteKey”,“写api键”);

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

例子:thingSpeakWrite(17504,[2.3,1.2,3.2,0.1],'WriteKey','write API key','Timeout',15);

写入写入通道中字段的数据值的时间戳,指定为逗号分隔的对,由“时间戳”还有一个值。必须为MATLAB®datetime价值。所有时间戳必须是唯一的。如果您提交重复的时间戳,则所有更新都将被拒绝,否则,只有时间戳已经在通道中的更新才会被拒绝。

请注意

不要指定“时间戳”如果你指定了“值”作为一个时间表。

例子:thingSpeakWrite(17504,[2.3,1.2,3.2,0.1],'WriteKey','channel write api key','Timestamp',[datetime('2/6/2018 9:27:12','format','MM/dd/uuuu HH: MM:ss')]);

数据类型:datetime

输出参数

全部折叠

写入操作的通道响应,作为结构返回,其中字段的顺序如表所示。结构的字段表示写入通道字段的值:

描述
FieldX

FieldX数据为条目,最多8个字段

纬度

写操作的纬度

经度

写操作的经度

通道标识

通道识别号

创建

写操作和提要输入的日期时间

去年EntryID

最近频道更新的条目ID

创建

Datetime通道创建日期

更新

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

去年EntryID

最近频道更新的条目ID

高度

写操作的提升

限制

  • 所有时间戳必须是唯一的。不能使用与通道中现有数据匹配的时间戳写入新数据。

  • 允许的频道更新频率根据您的许可证类型而有所限制。看到常见问题如何购买获取具体信息。包含多个条目的更新(例如在表或时间表中)仅限于较慢的更新频率。对于免费帐户的用户,在一次呼叫中要发送的消息数thingSpeakWrite限制为960条消息。对于付费账户的用户,限制为14,400条消息。尝试以比允许的限制更快的速度发布将返回以下错误:请求太频繁。有关详细信息,请参阅文档中的限制。

更多关于

全部折叠

ThingSpeak

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

版本历史

在R2019a中引入

另请参阅

功能