创建图表
使用 HTTP GET 生成图表
请求
HTTP方法
GET
URL
https://api.thingspeak.com/channels/
<channel_id>
/charts/<field_id>
URL 参数
名称 | 描述 |
---|---|
| (必需)感兴趣的通道的通道 ID。 |
| (必填)感兴趣字段的字段 ID。 |
示例: https://api.thingspeak.com/channels/99990/charts/2
图表查询字符串参数
使用这些参数来调整图表属性。使用 ?
附加第一个参数,并使用 &
附加后续参数。
名称 | 描述 | 值类型 |
---|---|---|
title | (可选)图表标题。默认为通道名称。 | 字符串 |
xaxis | (可选)图表 x 轴标签。默认为“日期”。 | 字符串 |
yaxis | (可选)图表 y 轴标签。默认为字段名称。 | 字符串 |
color | (可选)线条颜色的十六进制值。默认值为 FF000(红色)。 | 字符串 |
bgcolor | (可选)背景颜色。默认为白色。 | 字符串 |
type | (可选)图表类型。默认为线图。 |
|
width | (可选)图表宽度以像素为单位,iframe 宽度大 20 px,默认图表宽度:400.设置为“自动”以根据其父容器自动调整图表大小。 | 整数 |
height | (可选)图表高度以像素为单位,iframe 高度大 20 px,默认图表高度:200.设置为“自动”以根据其父容器自动调整图表大小。 | 整数 |
dynamic | (可选)使图表根据更新中提到的时间间隔自动更新。默认为 false。 |
|
step | (可选)将图表绘制为步骤图。默认为 false。 |
|
yaxismin | (可选)图表 Y 轴的最小值。如果为空,则系统会自动计算该值。 | 小数 |
yaxismax | (可选)图表 Y 轴的最大值。如果为空,则系统会自动计算该值。 | 小数 |
update | (可选)自动更新图表的时间间隔(以秒为单位)。默认值为 15。 | 整数 |
Feed 查询字符串参数
使用这些参数来调整用于生成图表的通道数据的属性。如果没有前面的参数,则使用 ?
附加第一个参数,并使用 &
附加后续参数。否则,请在所有参数后附加 &
。
名称 | 描述 | 值类型 |
---|---|---|
api_key | (私有通道必需)为此特定通道指定读取 API 密钥。读取 API 密钥可在通道视图的 API 密钥选项卡上找到。 | 字符串 |
results | (可选)要检索的条目数。最大数量为 8000。默认值为 100。 | 整数 |
days | (可选)要包含在源中的之前 24 小时周期的数量。 | 整数 |
start | (可选)开始日期,格式为 YYYY-MM-DD%20HH:NN:SS。 | 日期时间 |
end | (可选)结束日期,格式为 YYYY-MM-DD%20HH:NN:SS。 | 日期时间 |
offset | (可选)用于显示结果的时区偏移。使用时区参数可以获得更高的准确性。 | 整数 |
min | (可选)响应中包含的最小值。 | 小数 |
max | (可选)响应中包含的最大值。 | 小数 |
round | (可选)四舍五入到这么多小数位。 | 整数 |
timescale | (可选)。在这么多分钟内获得第一个值。有效值为:10、15、20、30、60、240、720、1440,“每日”。 | integer or string |
sum | (可选)。获取这么多分钟的总和。有效值为:10、15、20、30、60、240、720、1440,“每日”。 | integer or string |
average | (可选)获取这么多分钟的平均值。有效值为 10、15、20、30、60、240、720、1440、“每天”。注意:计算平均值时,NaN 值被解释为 0 。 | 整数或字符串 |
median | (可选)获取这些分钟的中位数。有效值为:10、15、20、30、60、240、720、1440、“每日” | integer or string |
示例
您可以使用 Web 浏览器完成对 ThingSpeak™ RESTful API 的 GET HTTP 请求。要查看 HTTP 响应的格式,请点击链接或将其复制到您的浏览器。
修改图表显示参数
您可以使用 API请求中设置的参数修改图表显示属性。使用 title
添加自定义标题,使用 color
更改线条颜色,使用 width
指定绘图的自定义宽度像素。使用此 HTTP GET 创建图表:
响应是 chart,它用粉红色的线、自定义标题和宽视图显示土壤湿度测量值。数据来自 soil moisture monitor 发布到 ThingSpeak Channel 276330。
修改图表数据
您可以修改用于生成自定义图表的数据。使用 average
参数对设定的分钟数进行平均,days
选择多天的数据,最多 8000 个点,min
显示大于给定最小值的数据。使用此 HTTP GET 创建图表:
https://api.thingspeak.com/channels/276330/charts/1?average=240&days=7&min=200
响应为 chart,显示四天内 240 分钟窗口内的平均土壤湿度值,不包括任何值低于 200 的点。数据来自 soil moisture monitor 发布到 ThingSpeak Channel 276330。由于数据是动态的,此处的示例将与您看到的有所不同。