Questa pagina è stata tradotta con la traduzione automatica. Fai clic qui per vedere l’originale in inglese.

Crea grafico

Genera grafico con HTTP GET

Richiesta

Metodo HTTP

GET

URL

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

Parametri URL

Nome	Descrizione
`<channel_id>`	(Obbligatorio) ID canale per il canale di interesse.
`<field_id>`	(Obbligatorio) ID campo per il campo di interesse.

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

Parametri della stringa di query del grafico

Utilizzare questi parametri per regolare le proprietà del grafico. Utilizzare ? per aggiungere il primo parametro e & per i parametri successivi.

Nome	Descrizione	Tipo di valore
`title`	(Facoltativo) Titolo del grafico. L'impostazione predefinita è il nome del canale.	stringa
`xaxis`	(Facoltativo) Etichetta dell'asse x del grafico. L'impostazione predefinita è "Data".	stringa
`yaxis`	(Facoltativo) Etichetta dell'asse Y del grafico. Il valore predefinito è il nome del campo.	stringa
`color`	(Facoltativo) Valore esadecimale per il colore della linea. Il valore predefinito è FF000 (rosso).	stringa
`bgcolor`	(Facoltativo) Colore di sfondo. L'impostazione predefinita è bianco.	stringa
`type`	(Facoltativo) Tipo di grafico. L'impostazione predefinita è linea.	`line`, `bar`, `column`, `spline`
`width`	(Facoltativo) Larghezza del grafico in pixel, la larghezza dell'iframe è maggiore di 20 px, larghezza del grafico predefinita: 400. Imposta su auto per regolare automaticamente le dimensioni del grafico in base al contenitore principale.	numero intero
`height`	(Facoltativo) Altezza del grafico in pixel, l'altezza dell'iframe è maggiore di 20 px, altezza del grafico predefinita: 200. Imposta su auto per regolare automaticamente le dimensioni del grafico in base al contenitore principale.	numero intero
`dynamic`	(Facoltativo) Aggiorna automaticamente il grafico in base all'intervallo di tempo menzionato nell'aggiornamento. L'impostazione predefinita è false.	`true` oppure `false`
`step`	(Facoltativo) Disegna il grafico come un diagramma a passi. L'impostazione predefinita è false.	`true` oppure `false`
`yaxismin`	(Facoltativo) Valore minimo dell'asse Y del grafico. Se vuoto, il valore viene calcolato automaticamente.	decimale
`yaxismax`	(Facoltativo) Valore massimo dell'asse Y del grafico. Se vuoto, il valore viene calcolato automaticamente.	decimale
`update`	(Facoltativo) Intervallo di tempo in secondi per aggiornare automaticamente il grafico. Il valore predefinito è 15.	numero intero

Parametri della stringa di query del feed

Utilizzare questi parametri per regolare le proprietà dei dati del canale utilizzati per generare il grafico. Se non sono presenti parametri precedenti, utilizzare ? per aggiungere il primo parametro e & per i parametri successivi. Altrimenti aggiungi tutti i parametri con &.

Nome	Descrizione	Tipo di valore
`api_key`	(Obbligatorio per i canali privati) Specifica la chiave API di lettura per questo canale specifico. La chiave API di lettura è disponibile nella scheda Chiavi API della vista canale.	stringa
`results`	(Facoltativo) Numero di voci da recuperare. Il numero massimo è 8000. Il valore predefinito è 100.	numero intero
`days`	(Facoltativo) Numero di periodi di 24 ore prima di adesso da includere nel feed.	numero intero
`start`	(Facoltativo) Data di inizio nel formato AAAA-MM-GG%20HH:NN:SS.	datetime
`end`	(Facoltativo) Data di fine nel formato AAAA-MM-GG%20HH:NN:SS.	datetime
`offset`	(Facoltativo) Differenza del fuso orario utilizzata per visualizzare i risultati. Utilizza il parametro fuso orario per una maggiore precisione.	numero intero
`min`	(Facoltativo) Valore minimo da includere nella risposta.	decimale
`max`	(Facoltativo) Valore massimo da includere nella risposta.	decimale
`round`	(Facoltativo) Arrotondare a questo numero di cifre decimali.	numero intero
`timescale`	(Opzionale). Ottieni il primo valore in così tanti minuti. I valori validi sono: 10, 15, 20, 30, 60, 240, 720, 1440, “giornaliero".	`integer or string`
`sum`	(Opzionale). Ottieni la somma di questi minuti. I valori validi sono: 10, 15, 20, 30, 60, 240, 720, 1440, “giornaliero".	`integer or string`
`average`	(Facoltativo) Ottieni la media di questi minuti. I valori validi sono 10, 15, 20, 30, 60, 240, 720, 1440, "giornaliero". Nota: I valori `NaN` vengono interpretati come `0` quando si calcola la media.	numero intero o stringa
`median`	(Facoltativo) Ottieni la media di questi minuti. I valori validi sono: 10, 15, 20, 30, 60, 240, 720, 1440, "giornaliero"	`integer or string`

Risposta

Successo

Codice di stato HTTP

200 OK

Corpo

La risposta è un grafico ThingSpeak .

Errore

Per l'elenco completo, vedere Codici di errore.

Esempi

È possibile utilizzare il browser Web per completare le richieste GET HTTP all'API RESTful ThingSpeak™ . Per visualizzare il formato di una risposta HTTP, fai clic sul collegamento o copialo nel browser.

Modifica i parametri di visualizzazione del grafico

È possibile modificare le proprietà di visualizzazione del grafico utilizzando i parametri impostati nella richiesta API. Utilizzare title per aggiungere un titolo personalizzato, color per modificare il colore della linea e width per specificare una larghezza personalizzata per il grafico in pixel. Crea un grafico utilizzando questo HTTP GET:

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

La risposta è un chart che mostra la misurazione dell'umidità del suolo con una linea rosa, un titolo personalizzato e una visualizzazione ampia. I dati provengono da un post soil moisture monitor su ThingSpeak Channel 276330.

Modifica i dati del grafico

È possibile modificare i dati utilizzati per generare un grafico personalizzato. Utilizza il parametro average per calcolare la media su un determinato numero di minuti, days per selezionare un numero di giorni di dati, fino a 8000 punti, e min per mostrare dati più grandi di un valore minimo specificato. Crea un grafico utilizzando questo HTTP GET:

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

La risposta è un chart che visualizza i valori medi di umidità del suolo in una finestra di 240 minuti per quattro giorni, escludendo eventuali punti con un valore inferiore a 200. I dati provengono da un post soil moisture monitor su ThingSpeak Channel 276330. L'esempio qui sarà diverso da quello che vedi poiché i dati sono dinamici.

Crea grafico con i parametri Grafico e Feed

Puoi utilizzare sia i parametri del grafico che quelli del feed per creare un grafico con le proprietà desiderate. Utilizza title, xaxis color, type, width, height, average, yaxismax e dynamic per creare un grafico personalizzato. Crea un grafico utilizzando questo 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

La risposta è un chart che visualizza i valori medi della temperatura esterna in un intervallo di 10 minuti utilizzando i dati di temperatura dal campo 2 di ThingSpeak Channel 9.