Main Content

Diese Seite wurde mithilfe maschineller Übersetzung übersetzt. Klicken Sie hier, um die neueste Version auf Englisch zu sehen.

thingSpeakRead

Lesen Sie die im Kanal ThingSpeak gespeicherten Daten

alle in Seite reduzieren

Syntax

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

Beschreibung

Beispiel

data = thingSpeakRead(channelID) liest die neuesten Daten aus allen Feldern des angegebenen öffentlichen Kanals auf ThingSpeak.com und gibt die Daten als numerischen Typ zurück.

Beispiel

data = thingSpeakRead(channelID,Name=Value) verwendet zusätzliche Optionen, die durch ein oder mehrere Name=Value- Paarargumente angegeben werden. Um nichtnumerische Daten zu lesen, müssen Sie 'OutputFormat' angeben.

Beispiel

data = thingSpeakRead(___,ReadKey='channel Read API key') verwendet den API-Schlüssel ThingSpeak™ Read, um von einem privaten Kanal zu lesen.

Beispiel

[data,timestamps] = thingSpeakRead(___) gibt auch Zeitstempel vom angegebenen Kanal auf ThingSpeak.com zurück und kann alle Eingabeargumente in früheren Syntaxen enthalten.

Beispiel

[data,timestamps,channelInfo] = thingSpeakRead(___) gibt auch Kanalinformationen zurück.

Beispiele

alle reduzieren

Lesen Sie die letzten drei Datenpunkte aus den Feldern 1 und 4 eines öffentlichen Kanals und geben Sie die Daten in einen Zeitplan zurück.

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

Lesen Sie die Daten der letzten fünf Minuten aus den Feldern 1 und 4 eines öffentlichen Kanals und geben Sie die Daten in eine Tabelle zurück.

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.

Lesen Sie das neueste Ergebnis für alle Felder eines öffentlichen Kanals, einschließlich des Zeitstempels.

[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

Lesen Sie die letzten fünf Minuten der Daten aus den Feldern 1 und 4 eines öffentlichen Kanals, einschließlich der Zeitstempel und Kanalinformationen.

[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?'

Lesen Sie die Daten von 11:59:01 Uhr am 9. August 2018 bis 12:02:52 Uhr am 10. August 2018 für die Felder 1 und 4 eines öffentlichen Kanals, einschließlich der Zeitstempel und Kanalinformationen.

[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?'

Eingabeargumente

alle reduzieren

Die Kanalidentifikationsnummer, angegeben als positive Ganzzahl. Für private Kanäle müssen Sie außerdem das Argument ReadKey angeben.

Datentypen: double

Name-Wert-Argumente

Geben Sie optionale Argumentpaare als Name1=Value1,...,NameN=ValueN an, wobei Name der Argumentname und Value der entsprechende Wert ist. Name-Wert-Argumente müssen nach anderen Argumenten stehen, die Reihenfolge der Paare spielt jedoch keine Rolle.

„Verwenden Sie vor R2021a Kommas, um jeden Namen und Wert zu trennen, und schließen Sie“ Name „in Anführungszeichen ein.“

Beispiel: thingSpeakRead(12397,Location=true); thingSpeakRead(12397,'Location',true);

Zeitspanne für die Rückgabe gesammelter Daten, angegeben als Name-Wert-Paar bestehend aus 'DateRange' und einem Array von Werten, die [startdate,enddate] in MATLAB® haben $ datetime (MATLAB) Werte. Der ThingSpeak- Server begrenzt die Anzahl der zurückgegebenen Punkte auf maximal 8000. Passen Sie Ihre Reichweiten an oder tätigen Sie mehrere Anrufe, wenn Sie mehr als 8000 Datenpunkte benötigen.

Hinweis

Sie können DateRange nicht mit NumDays oder NumMinutes verwenden.

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

Kanalfeld-IDs, angegeben als Name-Wert-Paar bestehend aus Fields und numerischen Werten der Kanalfeld-ID, aus der Daten abgerufen werden sollen.

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

Indikator zur Anzeige von Positionsinformationen von Daten aus dem Kanal, angegeben als Name-Wert-Paar bestehend aus Location und einem logischen Wert. Zu den Standortinformationen gehören Breitengrad, Längengrad und Höhe.

Beispiel: thingSpeakRead(12397,Location=true);

Anzahl der Datentage, aus denen Daten extrahiert werden sollen, angegeben als Name-Wert-Paar bestehend aus 'NumDays' und einem numerischen Wert. Die Anzahl der Tage wird in 24-Stunden-Zeiträumen gemessen. Der ThingSpeak- Server begrenzt die Anzahl der zurückgegebenen Punkte auf maximal 8000. Passen Sie die Anzahl der Tage an oder tätigen Sie mehrere Anrufe, wenn Sie mehr als 8000 Datenpunkte benötigen.

Hinweis

Sie können NumDays nicht mit DateRange oder NumMinutes verwenden.

Beispiel: thingSpeakRead(12397,NumDays=2);

Anzahl der Datenminuten, aus denen Daten extrahiert werden sollen, angegeben als Name-Wert-Paar bestehend aus 'NumMinutes' und einem numerischen Wert. Die Anzahl der abzurufenden Datenminuten wird ab dem Zeitpunkt der Befehlsausgabe gemessen. Der ThingSpeak- Server begrenzt die Anzahl der zurückgegebenen Punkte auf maximal 8000. Passen Sie Ihre Minutenzahl an oder tätigen Sie mehrere Anrufe, wenn Sie mehr als 8000 Datenpunkte benötigen.

Hinweis

Sie können NumMinutes nicht mit DateRange oder NumDays verwenden.

Beispiel: thingSpeakRead(12397,NumMinutes=20);

Datentypen: double

Anzahl der zu extrahierenden Datenpunkte, angegeben als Name-Wert-Paar bestehend aus 'NumPoints' und einem numerischen Wert. Die Anzahl der Punkte oder Datenzeilen wird ab dem Zeitpunkt der Befehlsausgabe gezählt. Der ThingSpeak- Server begrenzt die Anzahl der zurückgegebenen Punkte auf maximal 8000.

Beispiel: thingSpeakRead(12397,NumPoints=200);

Klasse der Ausgabedaten, angegeben als durch Kommas getrenntes Paar bestehend aus 'OutputFormat' und einem Textwert. Gültige Werte sind 'matrix', 'table' und 'timetable'. Verwenden Sie für numerische Daten das Format 'matrix' . Sie können 'timetable' oder 'table' für alle nicht numerischen Daten verwenden. Das 'table' -Format gibt [data,channelInfo] aus, wobei data die Zeitstempel und die Daten aus den Feldern des Kanals enthält. Das 'timetable' -Format gibt [data,channelInfo] aus, wobei data ein Stundenplan ist und so viele Variablen enthält, wie 'fields' angefordert wurden .

Beispiel: thingSpeakRead(12397,OutputFormat='table');

Beispiel: thingSpeakRead(12397,OutputFormat='timetable');

Lese-API-Schlüssel des Kanals, angegeben als Name-Wert-Paar bestehend aus 'ReadKey' und einem Zeichenvektor, der einen Kanal-Lese-API-Schlüssel darstellt. Mit dem Read-API-Schlüssel können Sie Daten aus einem privaten Kanal lesen. Sie finden den Lese-API-Schlüssel für einen Kanal auf der Registerkarte „API-Schlüssel“ Ihrer ThingSpeak Kanalansicht. Wenn Sie Daten aus einem öffentlichen Kanal lesen, benötigen Sie keinen Lese-API-Schlüssel. Speichern Sie den Read-API-Schlüssel Ihres Kanals der Einfachheit halber in einer Variablen.

Beispiel: thingSpeakRead(12397,ReadKey='F6CSCVKX42WFZN9Y');

Datentypen: char

Timeout-Zeitraum für die Serververbindung, angegeben als Name-Wert-Paar bestehend aus 'Timeout' und einem numerischen Wert. Der Wert ist die Anzahl der Sekunden, die thingSpeakRead für die Verbindung mit dem Server zur Verfügung steht.

Beispiel: thingSpeakRead(12397,Timeout=15);

Ausgabeargumente

alle reduzieren

Daten vom Kanal, zurückgegeben als Array, Tabelle oder Zeitplan.

Zeitstempel jedes Datenelements, zurückgegeben als Array von datetime- Werten.

Datentypen: datetime

Kanalinformationen, zurückgegeben als Struktur mit Feldern in der in der Tabelle gezeigten Reihenfolge.

FeldBeschreibung
ChannelID

Kanalidentifikationsnummer

Name

Name des Kanals

Description

Kanal Beschreibung

Latitude

Breitengrad für den Kanal, wie in den Kanaleinstellungen angegeben

Longitude

Längengrad für den Kanal, wie in den Kanaleinstellungen angegeben

Altitude

Höhe für den Kanal, wie in den Kanaleinstellungen angegeben

Created

Datetime des Kanalerstellungsdatums

Updated

Datum und Uhrzeit der letzten Änderung der Kanaleinstellungen

Last EntryID

Eintrags-ID für das letzte Kanalupdate

Field Descriptions

Liste der Feldnamen

Field IDs

Liste der aktivierten Felder

URL

URL für Feeddaten

Mehr über

alle reduzieren

ThingSpeak

ThingSpeak ist ein IoT-Analyseplattformdienst, mit dem Sie Live-Datenströme in der Cloud aggregieren, visualisieren und analysieren können. Weitere Informationen finden Sie unter License Options und Commercial Use .

Versionsverlauf

Eingeführt in R2019a

Siehe auch

Funktionen