写东西

将数据写入ThingSpeak通道

描述

实例

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

实例

写东西(___,名称,值)使用一个或多个指定的附加选项名称,值对参数。

实例

回答=thingSpeakWrite(___)当写操作成功完成时,返回ThingSpeak™服务器提供的响应。

例子

全部折叠

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

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

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

响应=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)

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

%生成随机数据data =兰迪(10 10 3);%为数据生成时间戳tStamps=日期时间(“现在”)-分钟(9):分钟(1):日期时间(“现在”);channelID = 17504;%更改为您的频道IDwriteKey=“23 zlgobbu9twhg2h”;%更改你的写API密钥%向通道的每个字段写入10个值和时间戳thingSpeakWrite (channelID、数据“时间戳”tStamps,“WriteKey”writeKey)

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

生成随机数据dataField1 =兰迪(10 10 1);dataField2 =兰迪(10 10 1);%为数据生成时间戳tStamps = [datetime (“现在”)-分钟(9):分钟(1):日期时间(“现在”)];%创建时间表数据表=时间表(TSTAMP,数据字段1,数据字段2);信道ID=17504;%更改您的频道IDwriteKey=“23 zlgobbu9twhg2h”;%更改你的写API密钥%向通道的每个字段写入10个值和时间戳thingSpeakWrite (channelID dataTable,“WriteKey”writeKey)

输入参数

全部折叠

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

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

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

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

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

名称-值对的观点

指定可选的逗号分隔的字符对名称,值参数。名称是参数名和价值为对应值。名称必须出现在引号内。可以以任意顺序指定多个名称和值对参数Name1, Value1,…,的家.

例子: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,'Fields',[1,3,4],'Values',[1,2,3],'WriteKey','channelwrite api key');

通道中数据的位置信息,指定为逗号分隔的对,包括“位置”和数字数组。位置信息包括纬度、经度和海拔高度。这个示例为字段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”,“写API键”,“超时”,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个字段

纬度

写入操作的纬度

经度

写入操作的经度

通道ID

通道标识号

创建

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

最后入口

最新频道更新的条目ID

创建

频道创建日期的日期时间

更新

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

最后入口

最新频道更新的条目ID

海拔高度

写入操作的提升

限制

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

  • 通道允许的更新频率根据许可证类型受到限制。看到常见问题如何购买用于特定信息。具有多个条目的更新(如在表格或时间表中)仅限于较慢的更新频率。对于免费帐户的用户,一次呼叫到写东西限制为960封邮件。对于付费帐户的用户,限制为14400封邮件。尝试以高于允许限制的速度发布邮件将返回以下错误:请求太频繁。有关详细信息,请参阅文档中的限制。

更多关于

全部折叠

ThingSpeak

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

另见

功能

在R2019a中引入