Main Content

本页采用了机器翻译。点击此处可查看英文原文。

创建图表

使用 HTTP GET 生成图表

请求

HTTP方法

GET

URL

https://api.thingspeak.com/channels/<channel_id>/charts/<field_id>

URL 参数

名称描述

<channel_id>

(必需)感兴趣的通道的通道 ID。

<field_id>

(必填)感兴趣字段的字段 ID。

示例: https://api.thingspeak.com/channels/99990/charts/2

图表查询字符串参数

使用这些参数来调整图表属性。使用 ? 附加第一个参数,并使用 & 附加后续参数。

名称描述值类型
title

(可选)图表标题。默认为通道名称。

字符串

xaxis

(可选)图表 x 轴标签。默认为“日期”。

字符串

yaxis

(可选)图表 y 轴标签。默认为字段名称。

字符串

color

(可选)线条颜色的十六进制值。默认值为 FF000(红色)。

字符串

bgcolor

(可选)背景颜色。默认为白色。

字符串

type

(可选)图表类型。默认为线图。

linebarcolumnspline

width

(可选)图表宽度以像素为单位,iframe 宽度大 20 px,默认图表宽度:400.设置为“自动”以根据其父容器自动调整图表大小。

整数

height

(可选)图表高度以像素为单位,iframe 高度大 20 px,默认图表高度:200.设置为“自动”以根据其父容器自动调整图表大小。

整数

dynamic

(可选)使图表根据更新中提到的时间间隔自动更新。默认为 false。

truefalse

step(可选)将图表绘制为步骤图。默认为 false。

truefalse

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

响应

成功

HTTP 状态代码

200 OK

主体

响应是 ThingSpeak 图表。

错误

完整列表请参见 错误代码

示例

您可以使用 Web 浏览器完成对 ThingSpeak™ RESTful API 的 GET HTTP 请求。要查看 HTTP 响应的格式,请点击链接或将其复制到您的浏览器。

修改图表显示参数

您可以使用 API请求中设置的参数修改图表显示属性。使用 title 添加自定义标题,使用 color 更改线条颜色,使用 width 指定绘图的自定义宽度像素。使用此 HTTP GET 创建图表:

https://api.thingspeak.com/channels/276330/charts/7?title=Soil%20Moisture&color=FF69B4&width=850&xaxis=Time

响应是 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。由于数据是动态的,此处的示例将与您看到的有所不同。

使用图表和 Feed 参数创建图表

您可以使用图表和源参数来创建具有所需属性的图表。使用 titlexaxiscolortypewidthheightaverageyaxismaxdynamic 创建自定义图表。使用此 HTTP GET 创建图表:

https://api.thingspeak.com/channels/38629/charts/2?title=Route%209%20Traffic&xaxis=Time&yaxis=Density%20of%20Eastbound%20Cars&color=0000FF&type=column&average=10&width=500&height=500&yaxismax=10&dynamic=true

响应是 chart,使用 ThingSpeak Channel 9 字段 2 的温度数据显示 10 分钟窗口内的平均室外温度值。