Diese Seite wurde mithilfe maschineller Übersetzung übersetzt. Klicken Sie hier, um das englische Original zu sehen.

thingSpeakRead

Lesen Sie die im ThingSpeak-Kanal 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

data = thingSpeakRead(channelID) liest die aktuellsten 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 nicht numerische Daten zu lesen, müssen Sie 'OutputFormat' angeben.

Beispiel

data = thingSpeakRead(___,ReadKey='channel Read API key') verwendet den ThingSpeak™ Read-API-Schlüssel, 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 vorherigen Syntaxen enthalten.

Beispiel

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

Beispiel

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 aktuellste 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 vom 9. August 2018, 11:59:01 Uhr, bis zum 10. August 2018, 12:02:52 Uhr, 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 auch das Argument ReadKey angeben.

Datentypen: double

Name-Wert-Argumente

alle reduzieren

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 erscheinen, die Reihenfolge der Paare spielt jedoch keine Rolle.

Trennen Sie vor R2021a jeden Namen und Wert durch Kommas und setzen Sie Name in Anführungszeichen.

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

Zeitraum für die Rückgabe der gesammelten Daten, angegeben als Name-Wert-Paar bestehend aus 'DateRange' und einem Werte-Array mit [startdate,enddate] in MATLAB® datetime (MATLAB)-Werten. Der ThingSpeak-Server begrenzt die Anzahl der zurückgegebenen Punkte auf maximal 8000. Passen Sie Ihre Bereiche 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 zu 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 Tage mit Daten, 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 8.000 Datenpunkte benötigen.

Hinweis

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

Beispiel: thingSpeakRead(12397,NumDays=2);

Anzahl der Minuten der Daten, aus denen Daten extrahiert werden sollen, angegeben als Name-Wert-Paar bestehend aus 'NumMinutes' und einem numerischen Wert. Die Anzahl der Minuten, in denen Daten abgerufen werden sollen, wird ab dem Zeitpunkt der Befehlsausgabe gemessen. Der ThingSpeak-Server begrenzt die Anzahl der zurückgegebenen Punkte auf maximal 8000. Passen Sie Ihre Minutenanzahl 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 kommagetrenntes Paar bestehend aus 'OutputFormat' und einem Textwert. Gültige Werte sind 'matrix', 'table' und 'timetable'. Verwenden Sie das 'matrix'-Format für numerische Daten. Sie können 'timetable' oder 'table' für alle nicht numerischen Daten verwenden. Das Format 'table' gibt [data,channelInfo] aus, wobei data die Zeitstempel und die Daten aus den Feldern des Kanals enthält. Das Format 'timetable' gibt [data,channelInfo] aus, wobei data ein Zeitplan ist und so viele Variablen enthält wie die Anzahl der angeforderten 'fields'.

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

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

Read-API-Schlüssel des Kanals, angegeben als Name-Wert-Paar bestehend aus 'ReadKey' und einem Zeichenvektor, der einen Read-API-Schlüssel des Kanals darstellt. Mit dem Read-API-Schlüssel können Sie Daten aus einem privaten Kanal lesen. Sie finden den Read-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 Read-API-Schlüssel. Speichern Sie den API-Schlüssel Ihres Kanals zum Lesen 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 gibt die Anzahl der Sekunden an, die thingSpeakRead für die Verbindung mit dem Server zur Verfügung stehen.

Beispiel: thingSpeakRead(12397,Timeout=15);

Ausgabeargumente

alle reduzieren

Daten aus dem 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 angezeigten Reihenfolge.

FeldBeschreibung
ChannelID

Kanalidentifikationsnummer

Name

Name des Kanals

Description

Kanalbeschreibung

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

Datum und Uhrzeit des Kanalerstellungsdatums

Updated

Datum und Uhrzeit der letzten Änderung der Kanaleinstellungen

Last EntryID

Eintrags-ID für das neueste Kanalupdate

Field Descriptions

Liste der Feldnamen

Field IDs

Liste der aktivierten Felder

URL

URL für Feeddaten

Mehr über

alle reduzieren

Versionsverlauf

Eingeführt in R2019a

Siehe auch

Funktionen