主要内容

thingSpeakWrite

写数据ThingSpeak通道

描述

例子

thingSpeakWrite (channelID,数据,“WriteKey”、“频道写API密匙”)将数据写到指定的通道。编写API键指定为逗号分隔对组成的“WriteKey”和一个特征向量或字符串代表频道写关键。

例子

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

例子

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

写混合nonconsecutive字段值(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 = datetime (“现在”)thingSpeakWrite (17504, (2.3, 1.2, 3.2, 0.1),“WriteKey”,“23 zlgobbu9twhg2h”,“时间戳”tStamp)

写一个矩阵的前三个字段的数据通道。提供的时间戳是解释为当地时间。

%产生随机数据data =兰迪(10 10 3);%为数据生成时间戳tStamps = datetime (“现在”(1)分钟(9):分钟):datetime (“现在”);channelID = 17504;变化百分比通道IDwriteKey =“23 zlgobbu9twhg2h”;变化百分比编写API密匙%写10每个字段的值随着时间戳你的频道thingSpeakWrite (channelID、数据“时间戳”tStamps,“WriteKey”writeKey)

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

%产生随机数据dataField1 =兰迪(10 10 1);dataField2 =兰迪(10 10 1);%为数据生成时间戳tStamps = [datetime (“现在”(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‘上’,‘好’},WriteKey,通道编写api键);

编写API密匙的渠道,指定为逗号分隔两人组成的“WriteKey”和一个特征向量代表频道写API密匙。编写API键需要写数据到一个通道。你可以找到一个通道的编写API密匙ThingSpeak通道的API密钥标签视图。保存您的频道为方便编写API密匙在一个变量中。

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

名称-值参数

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

R2021a之前,用逗号来分隔每一个名称和值,并附上的名字在报价。

例子:thingSpeakWrite(17504[1.1, 2.2],“字段”,[1,2,3],“WriteKey”,“频道写api键”);

通道id字段,指定为逗号分隔两人组成的“字段”1)×(n正整数的值。

例子:thingSpeakWrite(17504(2.3, 1.2, 3.2, 0.1),“字段”,(1、2、3、4),“WriteKey”,频道写api键);

数据值,指定为逗号分隔两人组成的“值”和数字标量数值向量,一个细胞数组,字符串的细胞阵列,表,或时间值。指定要写入的数据字段指定的频道“字段”参数。

例子: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”,“写API键”,“超时”,15);

时间戳数据值写入字段的写通道,指定为逗号分隔两人组成的“时间戳”和一个值。的值必须是MATLAB®datetime价值。所有时间戳必须是唯一的。如果你提交重复的时间戳,你所有的更新都拒绝,否则只有更新时间戳在频道已经拒绝了。

请注意

没有指定“时间戳”如果你有指定的“值”作为一个时间表。

例子:thingSpeakWrite (17504, (2.3, 1.2, 3.2, 0.1),“WriteKey”,“频道写api键”,“时间戳”,[datetime(“2/6/2018 9:27:12’,‘格式’,‘MM / dd /哦哦HH: MM: ss”)));

数据类型:datetime

输出参数

全部折叠

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

描述
FieldX

FieldX数据条目,8个字段

纬度

写操作的纬度

经度

写操作的经度

通道标识

通道标识号

创建

Datetime的写操作和提要条目

去年EntryID

最近的通道更新条目ID

创建

Datetime的通道创建日期

更新

Datetime通道设置在去年发生了变化

去年EntryID

最近的通道更新条目ID

高度

写操作的高度

限制

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

  • 允许更新频率通道是基于您的许可类型有限。看到常见问题如何购买为特定的信息。更新与多个条目,如在一个表或时间表,仅限于更新频率越慢。为用户的免费账户,在单个调用的消息的数量thingSpeakWrite仅限于960条消息。为用户的付费账户,极限是14400条消息。试图发布速度快于允许限制将返回如下错误:请求过于频繁。为进一步的信息,请参见文档的局限性。

更多关于

全部折叠

ThingSpeak

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

版本历史

介绍了R2019a

另请参阅

功能