Questa pagina è stata tradotta con la traduzione automatica. Fai clic qui per vedere l'ultima versione in inglese.

thingSpeakRead

Leggi 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 della 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 qualsiasi argomento di input nelle sintassi precedenti.

esempio

[data,timestamps,channelInfo] = thingSpeakRead(___) restituisce anche le 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 un orario.

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

Leggi gli ultimi cinque minuti di dati dai campi 1 e 4 di un canale pubblico e restituisci 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

Leggi gli ultimi cinque minuti di dati dai campi 1 e 4 di un canale pubblico, inclusi timestamp e 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 timestamp e 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

Il numero di identificazione 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 di argomenti facoltative come Name1=Value1,...,NameN=ValueN, dove Name è il nome dell'argomento e Value è il valore corrispondente. Gli argomenti nome-valore devono apparire dopo gli altri argomenti, ma l'ordine delle coppie non ha importanza.

Prima di R2021a, utilizzare le virgole per separare ciascun 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 [startdate,enddate] in MATLAB® datetime (MATLAB) valori. Il server ThingSpeak limita il numero di punti restituiti a un massimo di 8000. Modifica i tuoi intervalli o effettua più chiamate se hai bisogno di più di 8000 punti dati.

Nota

Non è possibile utilizzare DateRange con NumDays o NumMinutes.

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

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

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

Indicatore per visualizzare le informazioni sulla posizione dei dati 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 viene 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 o 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 dal momento in cui viene emesso il comando. Il server ThingSpeak limita il numero di punti restituiti a un massimo di 8000. Modifica il numero di minuti o 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 emesso 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 quanto il numero di 'fields' richiesti .

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

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

Chiave API di lettura 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 visualizzazione canale ThingSpeak . Se stai leggendo dati da un canale pubblico, non hai bisogno di una chiave API di lettura. Salva la chiave API Leggi il tuo canale in una variabile per comodità.

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 concessi a thingSpeakRead per connettersi al server.

Esempio thingSpeakRead(12397,Timeout=15);

Argomenti di output

comprimi tutto

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

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

Tipi di dati: datetime

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

CampoDescrizione
ChannelID

Numero identificativo del canale

Name

Nome del canale

Description

Descrizione del canale

Latitude

Latitudine del canale come fornita nelle impostazioni del canale

Longitude

Longitudine del canale come fornita nelle impostazioni del canale

Altitude

Elevazione per il canale come previsto nelle impostazioni del canale

Created

Data e ora della data di creazione del canale

Updated

Data e ora dell'ultima modifica delle impostazioni dei canali

Last EntryID

ID voce 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