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 |
|---|---|
| (Erforderlich) Kanal-ID für den gewünschten Kanal. |
| (Erforderlich) Feld-ID für das Interessenfeld. |
Beispiel: https://api.thingspeak.com/channels/99990/charts/2
Zeichenfolgenparameter für Diagrammabfrage
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 „Date“. | Zeichenfolge |
yaxis | (Optional) Beschriftung der Y-Achse 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“. |
|
width | (Optional) Diagrammbreite in Pixeln, iframe-Breite ist 20 Pixel größer, Standarddiagrammbreite: 400. Auf auto einstellen, um die Diagrammgröße automatisch basierend auf dem übergeordneten Container anzupassen. | ganze Zahl |
height | (Optional) Diagrammhöhe in Pixeln, iframe-Höhe ist 20 Pixel größer, Standarddiagrammhöhe: 200. Auf auto einstellen, um die Diagrammgröße automatisch basierend auf dem übergeordneten Container anzupassen. | ganze Zahl |
dynamic | (Optional) Führen Sie eine automatische Diagrammaktualisierung basierend auf dem im Update angegebenen Zeitintervall durch. Der Standardwert ist „false“. |
|
step | (Optional) Zeichnen Sie das Diagramm als Stufendiagramm. Der Standardwert ist „false“. |
|
yaxismin | (Optional) Mindestwert der Y-Achse des Diagramms. Wenn das Feld leer ist, wird der Wert automatisch berechnet. | dezimal |
yaxismax | (Optional) Maximalwert der Y-Achse des Diagramms. Wenn das Feld 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 |
Zeichenfolgenparameter für Feed-Abfrage
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 Read-API-Schlüssel für diesen bestimmten Kanal an. Der API-Schlüssel zum Lesen ist auf der Registerkarte „API Keys“ 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 24-Stunden-Zeiträume vor dem aktuellen Zeitpunkt, die in den Feed aufgenommen werden sollen. | ganze Zahl |
start | (Optional) Startdatum im Format JJJJ-MM-TT%20HH:NN:SS. | Datum/Uhrzeit |
end | (Optional) Enddatum im Format JJJJ-MM-TT%20HH:NN:SS. | Datum/Uhrzeit |
offset | (Optional) Zeitzonen-Offset, der zum Anzeigen der Ergebnisse verwendet wird. Verwenden Sie den Zeitzonenparameter für eine höhere Genauigkeit. | ganze Zahl |
min | (Optional) Mindestwert, der in die Antwort aufgenommen werden soll. | dezimal |
max | (Optional) Maximalwert, der in die Antwort aufgenommen werden soll. | dezimal |
round | (Optional) Auf diese Anzahl Dezimalstellen runden. | ganze Zahl |
timescale | (Optional). Den ersten Wert in so vielen Minuten erhalten. Die gültigen Werte sind: 10, 15, 20, 30, 60, 240, 720, 1440, „täglich“. | integer or string |
sum | (Optional). Die erste Summe in so vielen Minuten erhalten. Die gültigen Werte sind: 10, 15, 20, 30, 60, 240, 720, 1440, „täglich“. | integer or string |
average | (Optional) Den ersten Durchschnitt in so vielen Minuten erhalten. Die gültigen Werte sind 10, 15, 20, 30, 60, 240, 720, 1440, „täglich“. Hinweis: NaN-Werte werden bei der Berechnung des Durchschnitts als 0 interpretiert. | Ganzzahl oder Zeichenfolge |
median | (Optional) Den ersten Median in so vielen Minuten erhalten. Die gültigen Werte sind: 10, 15, 20, 30, 60, 240, 720, 1440, „täglich“ | integer or string |
Antwort
Erfolg
200 OK
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 zu senden. Um das Format einer HTTP-Antwort anzuzeigen, klicken Sie auf den Link oder kopieren Sie ihn in Ihren Browser.
Ändern der Diagrammanzeigeparameter
Sie können die Anzeigeeigenschaften des Diagramms mithilfe der in der API-Anforderung festgelegten Parameter ändern. Verwenden Sie title, um einen eigenen Titel hinzuzufügen, color, um die Linienfarbe zu ändern und width, um eine benutzerdefinierte Breite für das Diagramm in Pixeln anzugeben. Erstellen Sie ein Diagramm mit diesem HTTP GET:
Die Antwort ist ein Diagramm, das die Bodenfeuchtigkeitsmessung mit einer rosa Linie, einem benutzerdefinierten Titel und einer breiten Ansicht anzeigt. Die Daten stammen von einem Bodenfeuchtigkeitsmonitor, der auf ThingSpeak -Kanal 276330 gepostet wurde.
Diagrammdaten ändern
Sie können die zum Generieren eines benutzerdefinierten Diagramms verwendeten Daten ändern. Verwenden Sie den Parameter average, um den Durchschnitt über eine festgelegte Anzahl von Minuten zu ermitteln, days, um Daten für mehrere Tage (bis zu 8000 Punkte) auszuwählen, 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 Diagramm, 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 von einem Bodenfeuchtigkeitsmonitor, der auf ThingSpeak -Kanal 276330 gepostet wurde. Das Beispiel hier wird sich von dem Ergebnis unterscheiden, 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, xaxis, color, type, width, height, average, yaxismax und dynamic, um ein benutzerdefiniertes Diagramm zu erstellen. Erstellen Sie ein Diagramm mit diesem HTTP GET:
Die Antwort ist ein Diagramm, das die durchschnittlichen Außentemperaturwerte über ein 10-Minuten-Fenster unter Verwendung der Temperaturdaten aus Feld 2 von ThingSpeak Kanal 9 anzeigt.
