このページは機械翻訳を使用して翻訳されました。元の英語を参照するには、ここをクリックします。

チャートの作成

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`	(オプション) グラフのタイトル。デフォルトはチャネル名です。	string
`xaxis`	(オプション) グラフの X 軸のラベル。デフォルトは「日付」です。	string
`yaxis`	(オプション) グラフの Y 軸のラベル。デフォルトはフィールド名です。	string
`color`	(オプション) 線の色の 16 進値。デフォルトはFF000（赤）です。	string
`bgcolor`	(オプション) 背景色。デフォルトは白です。	string
`type`	(オプション) グラフのタイプ。デフォルトは行です。	`line`, `bar`, `column`, `spline`
`width`	(オプション) グラフの幅 (ピクセル単位)。iframe の幅は 20 ピクセル大きくなります。デフォルトのグラフの幅:400。auto に設定すると、親コンテナに基づいてチャートのサイズが自動的に調整されます。	整数
`height`	(オプション) グラフの高さ (ピクセル単位)、iframe の高さは 20 ピクセル大きくなります、デフォルトのグラフの高さ:200。auto に設定すると、親コンテナに基づいてチャートのサイズが自動的に調整されます。	整数
`dynamic`	(オプション) 更新で指定された時間間隔に基づいてチャートを自動的に更新します。デフォルトは false です。	`true` または `false`
`step`	(オプション) チャートをステップチャートとして描画します。デフォルトは false です。	`true` または `false`
`yaxismin`	(オプション) チャートの Y 軸の最小値。空白の場合、値は自動計算されます。	小数
`yaxismax`	(オプション) チャートの Y 軸の最大値。空白の場合、値は自動計算されます。	小数
`update`	(オプション) グラフを自動的に更新する時間間隔 (秒単位)。デフォルトは 15 です。	整数

フィードクエリ文字列パラメーター

これらのパラメーターを使用して、チャートの生成に使用されるチャネルデータのプロパティを調整します。前にパラメーターがない場合は、 ?を使用して最初のパラメーターを追加し、後続のパラメーターには&。それ以外の場合は、すべてのパラメーターに&を追加します。

名前	説明	値のタイプ
`api_key`	(プライベートチャネルの場合は必須) この特定のチャネルの読み取り API キーを指定します。Read API キーは、チャネルビューの [API キー] タブで利用できます。	string
`results`	(オプション) 取得するエントリの数。最大数は 8000 です。既定の設定は 100 です。	整数
`days`	(オプション) フィードに含める、これまでの 24 時間の期間の数。	整数
`start`	(オプション) YYYY-MM-DD%20HH:NN:SS 形式の開始日。	datetime
`end`	(オプション) YYYY-MM-DD%20HH:NN:SS 形式の終了日。	datetime
`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で、土壌水分測定値をピンクの線、カスタムタイトル、ワイドビューで表示します。データは、 ThingSpeak soil moisture monitorに投稿されたChannel 276330からのものです。

チャートデータの変更

カスタムグラフの生成に使用されるデータを変更できます。averageパラメーターを使用すると、設定した分数の平均を取得できます。TG daysを使用すると、日数分のデータ (最大 8000 ポイント) を選択でき、 min は、指定された最小値より大きいデータを表示します。この HTTP GETを使用してグラフを作成します。

https://api.thingspeak.com/channels/276330/charts/1?average=240&days=7&min=200

応答はchartで、値が 200 未満のポイントを除いた、4 日間の 240 分のウィンドウにわたる平均土壌水分値を表示します。データは、 ThingSpeak soil moisture monitorに投稿されたChannel 276330からのものです。データは動的であるため、ここでの例は実際に表示されるものとは異なります。

チャートとフィードパラメーターを使用してチャートを作成する

グラフとフィードの両方のパラメーターを使用して、必要なプロパティを備えたグラフを作成できます。title、 xaxis、 color、 type、 widthを使用します。、 height、 average、 yaxismax、 dynamicを使用してカスタムグラフを作成します。この 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

応答は、 ThingSpeak chartのフィールド 2 の温度データを使用して、10 分間の平均外気温値を表示するChannel 9です。