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

thingSpeakRead

Leggere i dati memorizzati nel canale ThingSpeak

comprimi tutto nella pagina

Sintassi

data = thingSpeakRead(channelID)
data = thingSpeakRead(channelID,Name=Value)
data = thingSpeakRead(___,ReadKey='channel Read API key')
[data,timestamps] = thingSpeakRead(___)
[data,timestamps,channelInfo] = thingSpeakRead(___)

Descrizione

data = thingSpeakRead(channelID) legge i dati più recenti da tutti i campi del canale pubblico specificato su ThingSpeak.com e restituisce i dati come tipo numerico.

esempio

data = thingSpeakRead(channelID,Name=Value) utilizza opzioni aggiuntive specificate da uno o più argomenti di coppia Name=Value. Per leggere dati non numerici, è necessario specificare 'OutputFormat'.

esempio

data = thingSpeakRead(___,ReadKey='channel Read API key') utilizza la chiave API di lettura ThingSpeak™ per leggere da un canale privato.

esempio

[data,timestamps] = thingSpeakRead(___) restituisce anche i timestamp dal canale specificato su ThingSpeak.com e può includere uno qualsiasi degli argomenti di input nelle sintassi precedenti.

esempio

[data,timestamps,channelInfo] = thingSpeakRead(___) restituisce anche informazioni sul canale.

esempio

Esempi

comprimi tutto

Leggere gli ultimi tre punti di dati dai campi 1 e 4 di un canale pubblico e restituire i dati in una tabella oraria.

data = thingSpeakRead(12397,'Fields',[1,4],NumPoints=3,OutputFormat='TimeTable')
data =

  3×2 timetable

         Timestamps         WindDirectionNorth0Degrees    TemperatureF
    ____________________    __________________________    ____________
    18-Nov-2021 13:42:57                34                    70.4    
    18-Nov-2021 13:43:57                50                    70.4    
    18-Nov-2021 13:44:57                54                    70.6

Leggere gli ultimi cinque minuti di dati dai campi 1 e 4 di un canale pubblico e restituire i dati in una tabella.

data = thingSpeakRead(12397,Fields=[1,4],NumMinutes=5,OutputFormat='TimeTable')
data =

  11×2 timetable

         Timestamps         WindDirectionNorth0Degrees    TemperatureF
    ____________________    __________________________    ____________

    18-Nov-2021 13:34:57                38                    70.6    
    18-Nov-2021 13:35:57                42                    70.6    
    18-Nov-2021 13:36:57                41                    70.6    
    18-Nov-2021 13:37:57                46                    70.8    
    18-Nov-2021 13:38:57                44                    70.8    
    18-Nov-2021 13:39:57                37                    70.8    
    18-Nov-2021 13:40:57                42                    70.6    
    18-Nov-2021 13:41:57                43                    70.4    
    18-Nov-2021 13:42:57                34                    70.4    
    18-Nov-2021 13:43:57                50                    70.4    
    18-Nov-2021 13:44:57                54                    70.6    
    18-Nov-2021 13:45:57                52                    70.

Leggi il risultato più recente per tutti i campi di un canale pubblico, incluso il timestamp.

[data,timestamps] = thingSpeakRead(12397)
data =
   52.0000    7.6000   58.0000   70.8000         0   29.6700    4.1360         0


timestamps = 

  datetime

   18-Nov-2021 13:45:57

Leggere gli ultimi cinque minuti di dati dai campi 1 e 4 di un canale pubblico, inclusi i timestamp e le informazioni sul canale.

[data,timestamps,channelInfo] = thingSpeakRead(12397,Fields=[1,4],NumMinutes=5)
data =

   41.0000   70.6000
   46.0000   70.8000
   44.0000   70.8000
   37.0000   70.8000
   42.0000   70.6000
   43.0000   70.4000
   34.0000   70.4000
   50.0000   70.4000
   54.0000   70.6000
   52.0000   70.8000
   39.0000   71.0000


timestamps = 

  11×1 datetime array

   18-Nov-2021 13:36:57
   18-Nov-2021 13:37:57
   18-Nov-2021 13:38:57
   18-Nov-2021 13:39:57
   18-Nov-2021 13:40:57
   18-Nov-2021 13:41:57
   18-Nov-2021 13:42:57
   18-Nov-2021 13:43:57
   18-Nov-2021 13:44:57
   18-Nov-2021 13:45:57
   18-Nov-2021 13:46:57


channelInfo = 

  struct with fields:

            ChannelID: 12397
                 Name: 'WeatherStation'
          Description: 'MathWorks Weather Station, West Garage, Natick, MA 01760, USA'
             Latitude: 42.2997
            Longitude: -71.3505
             Altitude: 60
              Created: 20-May-2014 17:50:32
              Updated: 18-Nov-2021 13:40:31
          LastEntryID: 3638608
    FieldDescriptions: {1×8 cell}
             FieldIDs: [1 2 3 4 5 6 7 8]
                  URL: 'https://api.thingspeak.com/channels/12397/feed.json?'

Leggi i dati dalle 11:59:01 del 9 agosto 2018 alle 12:02:52 del 10 agosto 2018 per i campi 1 e 4 di un canale pubblico, inclusi i timestamp e le informazioni sul canale.

[data,timestamps,channelInfo] = thingSpeakRead(12397,Fields=[1 4],...
    DateRange=[datetime(2018,8,9,23,59,01),datetime(2018,8,10,0,02,52)])
data =

  202.0000   83.3000
  184.0000   83.2000
  185.0000   83.1000
  155.0000   83.1000


timestamps = 

  4×1 datetime array

   09-Aug-2018 23:59:17
   10-Aug-2018 00:00:20
   10-Aug-2018 00:01:21
   10-Aug-2018 00:02:22


channelInfo = 

  struct with fields:

            ChannelID: 12397
                 Name: 'WeatherStation'
          Description: 'MathWorks Weather Station, West Garage, Natick, MA 01760, USA'
             Latitude: 42.2997
            Longitude: -71.3505
             Altitude: 60
              Created: 20-May-2014 17:50:32
              Updated: 14-May-2020 10:31:40
          LastEntryID: 2853000
    FieldDescriptions: {'Wind Direction (North = 0 degrees)'  'Wind Speed (mph)'  '% Humidity'  'Temperature (F)'  'Rain (Inches/minute)'  'Pressure ("Hg)'  'Power Level (V)'  'Light Intensity'}
             FieldIDs: [1 2 3 4 5 6 7 8]
                  URL: 'https://api.thingspeak.com/channels/12397/feed.json?'

Argomenti di input

comprimi tutto

Numero identificativo del canale, specificato come numero intero positivo. Per i canali privati, è necessario specificare anche l'argomento ReadKey.

Tipi di dati: double

Argomenti nome-valore

comprimi tutto

Specificare coppie facoltative di argomenti come Name1=Value1,...,NameN=ValueN, dove Name è il nome dell'argomento e Value è il valore corrispondente. Gli argomenti nome-valore devono comparire dopo gli altri argomenti, ma l'ordine delle coppie non ha importanza.

Prima di R2021a, utilizzare le virgole per separare ogni nome e valore e racchiudere Name tra virgolette.

Esempio thingSpeakRead(12397,Location=true); thingSpeakRead(12397,'Location',true);

Intervallo di tempo per la restituzione dei dati raccolti, specificato come coppia nome-valore composta da 'DateRange' e un array di valori che hanno valori [startdate,enddate] in MATLAB® datetime (MATLAB). Il server ThingSpeak limita il numero di punti restituiti a un massimo di 8000. Se hai bisogno di più di 8000 punti di dati, modifica gli intervalli o effettua più chiamate.

Nota

Non è possibile utilizzare DateRange con NumDays o NumMinutes.

Esempio thingSpeakRead(12397,DateRange=[datetime('Aug 8, 2014'),datetime('Aug 12, 2014')]);

ID del campo canale, specificati come coppia nome-valore composta da Fields e valori numerici dell'ID del campo canale da cui recuperare i dati.

Esempio thingSpeakRead(12397,Fields=[1,3,4]);

Indicatore per visualizzare le informazioni sulla posizione dei dati provenienti dal canale, specificate come coppia nome-valore composta da Location e un valore logico. Le informazioni sulla posizione includono latitudine, longitudine e altitudine.

Esempio thingSpeakRead(12397,Location=true);

Numero di giorni di dati da cui estrarre i dati, specificato come coppia nome-valore composta da 'NumDays' e un valore numerico. Il numero di giorni è misurato in periodi di 24 ore. Il server ThingSpeak limita il numero di punti restituiti a un massimo di 8000. Modifica il numero di giorni oppure effettua più chiamate se hai bisogno di più di 8000 punti dati.

Nota

Non è possibile utilizzare NumDays con DateRange o NumMinutes.

Esempio thingSpeakRead(12397,NumDays=2);

Numero di minuti di dati da cui estrarre i dati, specificato come coppia nome-valore composta da 'NumMinutes' e un valore numerico. Il numero di minuti di dati da recuperare viene misurato a partire dal momento in cui viene impartito il comando. Il server ThingSpeak limita il numero di punti restituiti a un massimo di 8000. Modifica il numero di minuti oppure effettua più chiamate se hai bisogno di più di 8000 punti dati.

Nota

Non è possibile utilizzare NumMinutes con DateRange o NumDays.

Esempio thingSpeakRead(12397,NumMinutes=20);

Tipi di dati: double

Numero di punti dati da estrarre, specificato come coppia nome-valore composta da 'NumPoints' e un valore numerico. Il numero di punti o righe di dati viene conteggiato dal momento in cui viene impartito il comando. Il server ThingSpeak limita il numero di punti restituiti a un massimo di 8000.

Esempio thingSpeakRead(12397,NumPoints=200);

Classe dei dati di output, specificata come coppia separata da virgole composta da 'OutputFormat' e un valore di testo. I valori validi sono 'matrix', 'table' e 'timetable'. Utilizzare il formato 'matrix' per i dati numerici. È possibile utilizzare 'timetable' o 'table' per qualsiasi dato non numerico. Il formato 'table' restituisce [data,channelInfo], dove data contiene i timestamp e i dati dai campi del canale. Il formato 'timetable' restituisce [data,channelInfo], dove data è un orario e contiene tante variabili quante sono le 'fields' richieste.

Esempio thingSpeakRead(12397,OutputFormat='table');

Esempio thingSpeakRead(12397,OutputFormat='timetable');

Leggere la chiave API del canale, specificata come coppia nome-valore composta da 'ReadKey' e un vettore di caratteri che rappresenta una chiave API di lettura del canale. La chiave API di lettura consente di leggere i dati da un canale privato. Puoi trovare la chiave API di lettura per un canale nella scheda Chiavi API della vista del tuo canale ThingSpeak. Se stai leggendo dati da un canale pubblico, non hai bisogno di una chiave API di lettura. Per comodità, salva la chiave API di lettura del tuo canale in una variabile.

Esempio thingSpeakRead(12397,ReadKey='F6CSCVKX42WFZN9Y');

Tipi di dati: char

Periodo di timeout della connessione al server, specificato come coppia nome-valore composta da 'Timeout' e un valore numerico. Il valore è il numero di secondi consentiti a thingSpeakRead per connettersi al server.

Esempio thingSpeakRead(12397,Timeout=15);

Argomenti di output

comprimi tutto

Dati dal canale, restituiti come array, tabella o orario.

Timestamp di ciascun elemento dati, restituito come array di valori datetime.

Tipi di dati: datetime

Informazioni sul canale, restituite come una struttura con campi nell'ordine mostrato nella tabella.

CampoDescrizione
ChannelID

Numero di identificazione del canale

Name

Nome del canale

Description

Descrizione del canale

Latitude

Latitudine per il canale come fornito nelle impostazioni del canale

Longitude

Longitudine del canale come fornita nelle impostazioni del canale

Altitude

Elevazione del canale come previsto nelle impostazioni del canale

Created

Datetime della data di creazione del canale

Updated

Datetime dell'ultima modifica delle impostazioni dei canali

Last EntryID

ID di ingresso per l'aggiornamento del canale più recente

Field Descriptions

Elenco dei nomi dei campi

Field IDs

Elenco dei campi abilitati

URL

URL per i dati del feed

Ulteriori informazioni

comprimi tutto

Cronologia versioni

Introdotto in R2019a

Vedi anche

Funzioni