thingSpeakWrite
写数据ThingSpeak通道
语法
描述
例子
将数据写入ThingSpeak通道
写多值并查看响应
将数值写入通道的前四个连续字段[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 = 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)
输入参数
channelID
- - - - - -通道标识号
数字
通道标识号,指定为正整数。
数据
- - - - - -要写入通道的数据
数组|数字|表格|时间表
要写入通道的数据,指定为数值标量或数值向量、单元格数组、单元格数组字符串、表或时间表。如果指定标量数据,则将值写入通道中的第一个字段(field 1)。对于向量或1- d单元格数组,数据将写入从field 1开始的连续字段。
例子:thingSpeakWrite(17504,{2,3,'on','good'},'WriteKey','通道写入api键');
通道写API键
- - - - - -写通道的API密钥
API Key的字符向量|string API Key的标量
通道的写API键,指定为逗号分隔的对,由“WriteKey”
和表示通道写API键的字符向量。写入API键是将数据写入通道所必需的。你可以在ThingSpeak频道视图的API Keys选项卡上找到一个频道的写API键。为方便起见,将通道写API键保存在变量中。
例子:thingSpeakRead (12397 ' WriteKey ', ' XXXXXXXXXXXXXXXX ');
名称-值参数
指定可选参数对为Name1 = Value1,…,以=家
,在那里的名字
参数名称和价值
对应的值。名-值参数必须出现在其他参数之后,但对的顺序并不重要。
在R2021a之前,名称和值之间用逗号隔开,并括起来的名字
在报价。
例子:thingSpeakWrite(17504,[1.1,2.2],'Fields',[1,2,3],'WriteKey','通道写api键');
字段
- - - - - -频道领域
数字
通道字段id,指定为逗号分隔的一对,由“字段”
一个1 × n的正整数。
例子:thingSpeakWrite(17504,[2.3,1.2,3.2,0.1],'Fields',[1,2,3,4],'WriteKey','通道写api键');
值
- - - - - -数据值
数字|数组|表格|时间表
数据值,指定为逗号分隔的对,由“值”
以及数值标量、数值向量、单元格数组、单元格数组字符串、表格或时间表值。控件指定要写入通道字段的数据“字段”
参数。
例子:thingSpeakWrite(17504,'Fields',[1,3,4],'Values',[1,2,3],'WriteKey','通道写入api键');
位置
- - - - - -数据位置信息
数字
通道中数据的位置信息,指定为逗号分隔的对,由“位置”
和数字数组。位置信息包括纬度、经度和海拔高度。本例为字段1中提供的三个点写入相同的位置信息。
例子:thingSpeakWrite(17504(2.3, 1.2, 3.2, 0.1),“位置”,(-40、23200),“WriteKey”,“写api键”);
超时
- - - - - -服务器连接超时时间
10(默认)|数字
服务器连接超时时间,以逗号分隔的对指定,由“超时”
和一个数值。超时时间是允许的秒数thingSpeakRead
在请求终止前连接到服务器。
例子:thingSpeakWrite(17504(2.3, 1.2, 3.2, 0.1),“WriteKey”,“写API键”,“超时”,15);
时间戳
- - - - - -数据值的时间戳
datetime
写入写入通道中字段的数据值的时间戳,指定为逗号分隔的对,由“时间戳”
和一个值。必须为MATLAB®datetime
价值。所有时间戳必须是唯一的。如果提交了重复的时间戳,则所有更新都将被拒绝,否则只有已经在通道中具有时间戳的更新才会被拒绝。
请注意
没有指定“时间戳”
如果您指定了“值”
作为一个时间表。
例子:thingSpeakWrite(17504,[2.3,1.2,3.2,0.1],'WriteKey','通道写入api键','Timestamp',[datetime('2/6/2018 9:27:12','format','MM/dd/uuuu HH: MM:ss')];
数据类型:datetime
输出参数
响应
—写操作的通道响应
结构
写操作的通道响应,以表中所示顺序的字段的结构形式返回。结构的字段表示写入通道字段的值:
场 | 描述 |
---|---|
FieldX |
FieldX数据为条目,最多8个字段 |
纬度 |
写操作的纬度 |
经度 |
写入操作的经度 |
通道标识 |
通道标识号 |
创建 |
写操作和提要输入的日期时间 |
去年EntryID |
最近的频道更新的条目ID |
创建 |
通道创建日期的Datetime |
更新 |
最后一次更改通道设置的日期时间 |
去年EntryID |
最近的频道更新的条目ID |
高度 |
用于写操作的高度 |
限制
更多关于
ThingSpeak
ThingSpeak是一个物联网分析平台服务,允许您在云中聚合、可视化和分析实时数据流。看到许可选项和商业用途为更多的信息。
版本历史
介绍了R2019a
MATLAB命令
你点击了一个对应于这个MATLAB命令的链接:
在MATLAB命令窗口中输入命令来运行该命令。Web浏览器不支持MATLAB命令。
您也可以从以下列表中选择网站:
如何获得最佳的网站性能
选择中国网站(中文或英文)以获得最佳的网站表现。其他MathWorks国家网站没有针对从您的位置访问进行优化。