Main Content

このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

チャートの作成

チャートを作成するには、次の URL にアクセスします (CHANNEL_IDFIELD_ID を使用するチャネルの値に置き換えます)。

http://api.thingspeak.com/channels/CHANNEL_ID/charts/FIELD_ID

チャート パラメーター

  • title (文字列) チャートのタイトル、既定: チャネル名 (オプション)

  • xaxis (文字列) チャートの x 軸ラベル、既定: "Date" (オプション)

  • yaxis (文字列) チャートの y 軸ラベル、既定: フィールド名 (オプション)

  • color (文字列) ラインの色、既定: red (オプション)

  • bgcolor (文字列) 背景色、既定: white (オプション)

  • type (line/bar/column/spline) チャートの種類、既定: line (オプション)

  • width (整数) ピクセル単位のチャート幅、iframe 幅は 20 px 大きくなります。既定のチャート幅: 400。auto に設定すると親コンテナーに基づいてチャートのサイズが自動的に調整されます (オプション)。

  • height (整数) ピクセル単位のチャートの高さ、iframe の高さは 20 px 大きくなります。既定のチャートの高さ: 200。auto に設定すると親コンテナーに基づいてチャートのサイズが自動的に調整されます (オプション)。

  • dynamic (true/false) update に記述された時間間隔に基づいて自動的にチャートを更新します。既定: false (オプション)

  • step (true/false) チャートをステップ チャートとして描画します。既定: false (オプション)

  • export (true/false) エクスポート ボタンを表示し、チャートをイメージとして保存できるようにします。既定: false (オプション)

  • yaxismin (10 進数) チャートの Y 軸の最小値。空白の場合は値が自動で計算されます (オプション)

  • yaxismax (10 進数) チャートの Y 軸の最大値。空白の場合は値が自動で計算されます (オプション)

  • update (整数) チャートを自動的に更新する秒単位の時間間隔、既定: 15 (オプション)

フィード パラメーター

  • api_key (文字列) この特定のチャネルの Read API キー (オプション -- 公開チャネルにはキーは必要なし)

  • results (整数) 取得するエントリの数、最大 8000、既定は 100 (オプション)

  • days (整数) フィードに含める現在より前の 24 時間単位の期間 (オプション)

  • start (日時) YYYY-MM-DD%20HH:NN:SS 形式の開始日 (オプション)

  • end (日時) YYYY-MM-DD%20HH:NN:SS 形式の終了日 (オプション)

  • offset (整数) 結果の表示で使用するタイムゾーン オフセット。正確性を高めるには timezone パラメーターを使用します (オプション)。

  • status (true/false) "status=true" に設定することでフィードにステータス更新を含めます (オプション)

  • location (true/false) "location=true" に設定することで緯度、経度、標高をフィードに含めます (オプション)

  • min (10 進数) 応答に含める最小値 (オプション)

  • max (10 進数) 応答に含める最大値 (オプション)

  • round (整数) 小数点以下をこの桁数に丸めます (オプション)

  • timescale (整数または文字列) この分数が経過した時点の最初の値を取得します。有効な値: 10、15、20、30、60、240、720、1440、"daily" (オプション)

  • sum (整数または文字列) この分数ごとの和を取得します。有効な値: 10、15、20、30、60、240、720、1440、"daily" (オプション)

  • average (整数または文字列) この分数ごとの平均を取得します。有効な値: 10、15、20、30、60、240、720、1440、"daily" (オプション)

  • median (整数または文字列) この分数ごとの中央値を取得します。有効な値: 10、15、20、30、60、240、720、1440、"daily" (オプション)

メモ

results パラメーターを timescalesumaverage、または median と組み合わせて使用することはできません。

チャート パラメーターとフィード パラメーターによるチャートの作成

チャート パラメーターとフィード パラメーターを設定して、チャートのタイトル、座標軸ラベル、チャートの色とタイプ、およびチャートの幅と高さを制御できます。また、平均値を表示し、Y 軸の最大値を調節して、チャートを動的に更新できます。さらに、チャート パラメーターおよびフィード パラメーターに記載されている他のパラメーターを追加してチャートを変更することもできます。

たとえば、縦棒グラフの作成に titlexaxisyaxiscolortypewidthheightaverageyaxismax、および dynamic の各パラメーターを使用できます。

http://api.thingspeak.com/channels/9/charts/2?title=Outside Ambient Temperature&xaxis=Time&yaxis=Average Temperature [F]&color=blue&type=column&width=500&height=500&average=10&yaxismax=100&dynamic=true
このチャートは、ThingSpeak のチャネル 9 の Field 2 にある温度データを使用して、10 分枠での平均屋外温度の値を表示しています。

関連するトピック