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 |
|---|---|
| (Obbligatorio) ID del canale di interesse. |
| (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. L'impostazione predefinita è 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. Il colore predefinito è il bianco. | stringa |
type | (Facoltativo) Tipo di grafico. L'impostazione predefinita è la linea. |
|
width | (Facoltativo) Larghezza del grafico in pixel, la larghezza dell'iframe è 20 px più grande, larghezza predefinita del grafico: 400. Impostare su auto per regolare automaticamente le dimensioni del grafico in base al contenitore padre. | intero |
height | (Facoltativo) Altezza del grafico in pixel, l'altezza dell'iframe è 20 px più grande, altezza predefinita del grafico: 200. Impostare su auto per regolare automaticamente le dimensioni del grafico in base al contenitore padre. | intero |
dynamic | (Facoltativo) Fai in modo che il grafico venga aggiornato automaticamente in base all'intervallo di tempo indicato nell'aggiornamento. Il valore predefinito è falso. |
|
step | (Facoltativo) Disegna il grafico come un grafico a gradini. Il valore predefinito è falso. |
|
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 l'aggiornamento automatico del grafico. Il valore predefinito è 15. | 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 ci sono parametri precedenti, utilizzare ? per aggiungere il primo parametro e & per i parametri successivi. Altrimenti aggiungere tutti i parametri con &.
| Nome | Descrizione | Tipo di valore |
|---|---|---|
api_key | (Obbligatorio per i canali privati) Specificare 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. | intero |
days | (Facoltativo) Numero di periodi di 24 ore precedenti a quello attuale da includere nel feed. | 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) Offset del fuso orario utilizzato per visualizzare i risultati. Per una maggiore precisione, utilizzare il parametro fuso orario. | 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. | intero |
timescale | (Opzionale). Ottieni il primo valore in pochi 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. | intero o stringa |
median | (Facoltativo) Ottieni la mediana di questi minuti. I valori validi sono: 10, 15, 20, 30, 60, 240, 720, 1440, "giornaliero" | integer or string |
Risposta
Successo
200 OK
La risposta è un grafico ThingSpeak.
Errore
Per l'elenco completo, vedere Codici di errore.
Esempi
Puoi utilizzare il tuo browser web per completare le richieste HTTP GET all'API RESTful ThingSpeak™. Per visualizzare il formato di una risposta HTTP, fare clic sul collegamento o copiarlo 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:
La risposta è un grafico che mostra la misurazione dell'umidità del suolo con una linea rosa, un titolo personalizzato e una vista ampia. I dati provengono da un monitoraggio dell'umidità del suolo pubblicato su ThingSpeak Canale 276330.
Modifica i dati del grafico
È possibile modificare i dati utilizzati per generare un grafico personalizzato. Utilizzare il parametro average per calcolare la media su un numero di minuti definito, 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 grafico che mostra i valori medi dell'umidità del suolo in un intervallo di 240 minuti per quattro giorni, escludendo tutti i punti con un valore inferiore a 200. I dati provengono da un monitoraggio dell'umidità del suolo pubblicato su ThingSpeak Canale 276330. L'esempio qui riportato sarà diverso da quello che vedi, poiché i dati sono dinamici.
Crea grafico con parametri grafico e feed
È possibile utilizzare sia i parametri del grafico che quelli del feed per creare un grafico con le proprietà desiderate. Utilizzare title, xaxis, color, type, width, height, average, yaxismax e dynamic per creare un grafico personalizzato. Crea un grafico utilizzando questo HTTP GET:
La risposta è un grafico che mostra i valori medi della temperatura esterna in una finestra temporale di 10 minuti utilizzando i dati sulla temperatura del campo 2 del Canale 9 ThingSpeak.
