Diese Seite wurde mithilfe maschineller Übersetzung übersetzt. Klicken Sie hier, um die neueste Version auf Englisch zu sehen.

Diagramm erstellen

Diagramm mit HTTP GET generieren

Anfrage

HTTP-Methode

GET

URL

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

URL-Parameter

Name	Beschreibung
`<channel_id>`	(Erforderlich) Kanal-ID für den gewünschten Kanal.
`<field_id>`	(Erforderlich) Feld-ID für das Interessengebiet.

Beispiel: https://api.thingspeak.com/channels/99990/charts/2

Parameter für Diagrammabfragezeichenfolgen

Verwenden Sie diese Parameter, um die Diagrammeigenschaften anzupassen. Verwenden Sie ? , um den ersten Parameter anzuhängen, und & für nachfolgende Parameter.

Name	Beschreibung	Werttyp
`title`	(Optional) Diagrammtitel. Der Standardwert ist der Kanalname.	Zeichenfolge
`xaxis`	(Optional) Beschriftung der X-Achse des Diagramms. Der Standardwert ist „Datum“.	Zeichenfolge
`yaxis`	(Optional) Y-Achsenbeschriftung des Diagramms. Der Standardwert ist der Feldname.	Zeichenfolge
`color`	(Optional) Hex-Wert für die Linienfarbe. Der Standardwert ist FF000 (rot).	Zeichenfolge
`bgcolor`	(Optional) Hintergrundfarbe. Die Standardeinstellung ist Weiß.	Zeichenfolge
`type`	(Optional) Diagrammtyp. Der Standardwert ist Linie.	`line`, `bar`, `column`, `spline`
`width`	(Optional) Diagrammbreite in Pixel, Iframe-Breite ist 20 Pixel größer, Standarddiagrammbreite: 400. Stellen Sie „Auto“ ein, um die Diagrammgröße basierend auf dem übergeordneten Container automatisch anzupassen.	ganze Zahl
`height`	(Optional) Diagrammhöhe in Pixel, Iframe-Höhe ist 20 Pixel größer, Standard-Diagrammhöhe: 200. Stellen Sie „Auto“ ein, um die Diagrammgröße basierend auf dem übergeordneten Container automatisch anzupassen.	ganze Zahl
`dynamic`	(Optional) Lassen Sie die Diagrammaktualisierung automatisch basierend auf dem in der Aktualisierung genannten Zeitintervall durchführen. Der Standardwert ist falsch.	`true` oder `false`
`step`	(Optional) Zeichnen Sie das Diagramm als Stufendiagramm. Der Standardwert ist falsch.	`true` oder `false`
`yaxismin`	(Optional) Mindestwert der Y-Achse des Diagramms. Wenn es leer ist, wird der Wert automatisch berechnet.	Dezimal
`yaxismax`	(Optional) Maximalwert der Y-Achse des Diagramms. Wenn es leer ist, wird der Wert automatisch berechnet.	Dezimal
`update`	(Optional) Zeitintervall in Sekunden, um das Diagramm automatisch zu aktualisieren. Der Standardwert ist 15.	ganze Zahl

Parameter der Feed-Abfragezeichenfolge

Verwenden Sie diese Parameter, um die Eigenschaften der Kanaldaten anzupassen, die zum Generieren des Diagramms verwendet werden. Wenn keine vorherigen Parameter vorhanden sind, verwenden Sie ? , um den ersten Parameter anzuhängen, und & für nachfolgende Parameter. Andernfalls hängen Sie alle Parameter mit & an.

Name	Beschreibung	Werttyp
`api_key`	(Erforderlich für private Kanäle) Geben Sie den Lese-API-Schlüssel für diesen bestimmten Kanal an. Der API-Schlüssel lesen ist auf der Registerkarte „API-Schlüssel“ der Kanalansicht verfügbar.	Zeichenfolge
`results`	(Optional) Anzahl der abzurufenden Einträge. Die maximale Anzahl beträgt 8000. Der Standardwert ist 100.	ganze Zahl
`days`	(Optional) Anzahl der bisherigen 24-Stunden-Zeiträume, die in den Feed aufgenommen werden sollen.	ganze Zahl
`start`	(Optional) Startdatum im Format JJJJ-MM-TT%20HH:NN:SS.	Terminzeit
`end`	(Optional) Enddatum im Format JJJJ-MM-TT%20HH:NN:SS.	Terminzeit
`offset`	(Optional) Zeitzonenoffset, der zum Anzeigen von Ergebnissen verwendet wird. Verwenden Sie den Zeitzonenparameter für eine höhere Genauigkeit.	ganze Zahl
`min`	(Optional) Mindestwert, der in die Antwort einbezogen werden soll.	Dezimal
`max`	(Optional) Maximaler Wert, der in die Antwort einbezogen werden soll.	Dezimal
`round`	(Optional) Runden Sie auf diese viele Dezimalstellen.	ganze Zahl
`timescale`	(Optional). Erhalten Sie innerhalb dieser Zeit (Minuten) den ersten Wert. Die gültigen Werte sind: 10, 15, 20, 30, 60, 240, 720, 1440, „daily“.	`integer or string`
`sum`	(Optional). Ermitteln Sie die Summe innerhalb dieser Zeit (Minuten). Die gültigen Werte sind: 10, 15, 20, 30, 60, 240, 720, 1440, „daily“.	`integer or string`
`average`	(Optional) Ermitteln Sie den Durchschnitt innerhalb dieser Zeit (Minuten). Die gültigen Werte sind 10, 15, 20, 30, 60, 240, 720, 1440, „daily“. Notiz: `NaN`- Werte werden bei der Berechnung des Durchschnitts als `0` interpretiert.	Ganzzahl oder Zeichenfolge
`median`	(Optional) Ermitteln Sie den Median innerhalb dieser Zeit (Minuten). Die gültigen Werte sind: 10, 15, 20, 30, 60, 240, 720, 1440, „daily“	`integer or string`

Antwort

Erfolg

HTTP-Statuscode

200 OK

Körper

Die Antwort ist ein ThingSpeak Diagramm.

Fehler

Die vollständige Liste finden Sie unter Fehlercodes.

Beispiele

Sie können Ihren Webbrowser verwenden, um GET-HTTP-Anfragen an die ThingSpeak™ RESTful-API auszuführen. Um das Format einer HTTP-Antwort anzuzeigen, klicken Sie auf den Link oder kopieren Sie ihn in Ihren Browser.

Ändern Sie die Diagrammanzeigeparameter

Sie können die Anzeigeeigenschaften des Diagramms mithilfe der in der API-Anfrage festgelegten Parameter ändern. Verwenden Sie title , um einen benutzerdefinierten Titel hinzuzufügen, color , um die Linienfarbe zu ändern, und width , um eine benutzerdefinierte Breite für den Plot anzugeben Pixel. Erstellen Sie ein Diagramm mit diesem HTTP-GET:

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

Die Antwort ist ein chart , das die Bodenfeuchtigkeitsmessung mit einer rosa Linie und einem benutzerdefinierten Titel sowie einer breiten Ansicht anzeigt. Die Daten stammen aus einem soil moisture monitor -Beitrag auf ThingSpeak Channel 276330.

Diagrammdaten ändern

Sie können die Daten ändern, die zum Generieren eines benutzerdefinierten Diagramms verwendet werden. Verwenden Sie den Parameter average , um über eine festgelegte Anzahl von Minuten zu mitteln, days, um Daten für eine Anzahl von Tagen auszuwählen, bis zu 8000 Punkte, und min , um Daten anzuzeigen, die größer als ein bestimmter Mindestwert sind. Erstellen Sie ein Diagramm mit diesem HTTP-GET:

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

Die Antwort ist ein chart , das die durchschnittlichen Bodenfeuchtigkeitswerte über einen Zeitraum von 240 Minuten für vier Tage anzeigt, wobei alle Punkte mit einem Wert unter 200 ausgeschlossen sind. Die Daten stammen aus einem soil moisture monitor -Beitrag auf ThingSpeak Channel 276330. Das hier gezeigte Beispiel unterscheidet sich von dem, was Sie sehen, da die Daten dynamisch sind.

Erstellen Sie ein Diagramm mit Diagramm- und Feed-Parametern

Sie können sowohl Diagramm- als auch Feed-Parameter verwenden, um ein Diagramm mit den gewünschten Eigenschaften zu erstellen. Verwenden Sie title , color, type, width, height, average, yaxismax und dynamic , um ein benutzerdefiniertes Diagramm zu erstellen. Erstellen Sie ein Diagramm mit diesem 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

Die Antwort ist ein chart , das die durchschnittlichen Außentemperaturwerte über ein 10-Minuten-Fenster unter Verwendung der Temperaturdaten aus Feld 2 von ThingSpeak Channel 9 anzeigt.