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

thingSpeakWrite

Daten in den Kanal ThingSpeak schreiben

Syntax

thingSpeakWrite(channelID,data,'WriteKey','channel write API key')

thingSpeakWrite(___,Name,Value)

response = thingSpeakWrite(___)

Beschreibung

thingSpeakWrite(channelID,data,'WriteKey','channel write API key') schreibt die Daten in den angegebenen Kanal. Der Schreib-API-Schlüssel wird als durch Kommas getrenntes Paar angegeben, das aus 'WriteKey' und einem Zeichenvektor oder einer Zeichenkette besteht, die den Kanalschreibschlüssel darstellt.

thingSpeakWrite(___,Name,Value) verwendet zusätzliche Optionen, die durch ein oder mehrere Name,Value- Paarargumente angegeben werden.

response = thingSpeakWrite(___) gibt die vom ThingSpeak™- Server bereitgestellte Antwort zurück, wenn der Schreibvorgang erfolgreich abgeschlossen wurde.

Beispiele

Daten in einen ThingSpeak Kanal schreiben

Schreiben Sie einen einzelnen numerischen Wert in Feld 1 eines Kanals.

thingSpeakWrite(17504,2.3,'WriteKey','23ZLGOBBU9TWHG2H')

Schreiben Sie mehrere Werte und zeigen Sie die Antwort an

Schreiben Sie numerische Werte in die ersten vier aufeinanderfolgenden Felder [1,2,3,4] eines Kanals.

response = thingSpeakWrite(17504,[2.3,1.2,3.2,0.1],'WriteKey','23ZLGOBBU9TWHG2H')

Schreiben Sie nichtnumerische Daten

Schreiben Sie nichtnumerische Daten in die ersten drei aufeinanderfolgenden Felder [1,2,3] eines Kanals.

thingSpeakWrite(17504,{2.3,'on','good'},'WriteKey','23ZLGOBBU9TWHG2H')

Gemischte Daten schreiben

Schreiben Sie gemischte Werte in nicht aufeinanderfolgende Felder [1,4,6] eines Kanals.

thingSpeakWrite(17504,'Fields',[1,4,6],'Values',{2.3,'on','good'},'WriteKey','23ZLGOBBU9TWHG2H')

Feld- und Standortdaten schreiben

Aktualisieren Sie drei Felder und schreiben Sie Breiten-, Längen- und Höhendaten für den Eintrag.

thingSpeakWrite(17504,[1.1,2.3,4],'Location',[-40,23,35],'WriteKey','23ZLGOBBU9TWHG2H')

Nur Standortdaten schreiben

Schreiben Sie Breiten-, Längen- und Höhendaten in einen Kanal, ohne den Feldern Werte hinzuzufügen.

thingSpeakWrite(17504,'Location',[-40,23,3500],'WriteKey','23ZLGOBBU9TWHG2H')

Daten mit Zeitstempel schreiben

Schreiben Sie einen Zeitstempel für den Wert, der in einen Kanal geschrieben wird. Der angegebene Zeitstempel wird als Ortszeit interpretiert.

tStamp = datetime('now')
thingSpeakWrite(17504,[2.3,1.2,3.2,0.1],'WriteKey','23ZLGOBBU9TWHG2H','TimeStamp',tStamp)

Schreiben Sie eine Datenmatrix

Schreiben Sie eine Datenmatrix in die ersten drei Felder eines Kanals. Die bereitgestellten Zeitstempel werden als Ortszeit interpretiert.

% Generate Random Data
data = randi(10,10,3);

% Generate timestamps for the data
tStamps = datetime('now')-minutes(9):minutes(1):datetime('now');

channelID = 17504; % Change to your Channel ID
writeKey = '23ZLGOBBU9TWHG2H'; % Change to your Write API Key

% Write 10 values to each field of your channel along with timestamps
thingSpeakWrite(channelID,data,'TimeStamp',tStamps,'WriteKey',writeKey)

Schreiben Sie einen Zeitplan mit Daten

Schreiben Sie einen Zeitplan mit Daten in die ersten beiden Felder eines Kanals. Die bereitgestellten Zeitstempel werden als Ortszeit interpretiert.

% Generate random data
dataField1 = randi(10,10,1);
dataField2 = randi(10,10,1);

% Generate timestamps for the data
tStamps = [datetime('now')-minutes(9):minutes(1):datetime('now')]';

% Create timetable
dataTable = timetable(tStamps,dataField1,dataField2);
channelID = 17504; % Change to your channel ID
writeKey  = '23ZLGOBBU9TWHG2H'; % Change to your Write API Key

% Write 10 values to each field of your channel along with timestamps
thingSpeakWrite(channelID,dataTable,'WriteKey',writeKey)

Eingabeargumente

channelID — Kanalidentifikationsnummer

numerisch

Die Kanalidentifikationsnummer, angegeben als positive Ganzzahl.

data — Daten, die in den Kanal geschrieben werden sollen

Array | numerisch | Tisch | Zeitplan

In den Kanal zu schreibende Daten, angegeben als numerischer Skalar oder numerischer Vektor, als Zellenarray, als Zeichenfolge von Zellenarrays, als Tabelle oder als Zeitplan. Wenn Sie Skalardaten angeben, wird der Wert in das erste Feld im Kanal (Feld 1) geschrieben. Bei einem Vektor oder einem 1-D-Zellenarray werden die Daten in aufeinanderfolgende Felder geschrieben, beginnend mit Feld 1.

Beispiel: thingSpeakWrite(17504,{2,3,'on','good'},'WriteKey','channel write api key');

channel write API key — API-Schlüssel des Kanals schreiben

Zeichenvektor des API-Schlüssels | String-Skalar des API-Schlüssels

Schreib-API-Schlüssel des Kanals, angegeben als durch Kommas getrenntes Paar bestehend aus 'WriteKey' und einem Zeichenvektor, der den Schreib-API-Schlüssel des Kanals darstellt. Der Write-API-Schlüssel ist erforderlich, um Daten in einen Kanal zu schreiben. Sie finden den Schreib-API-Schlüssel für einen Kanal auf der Registerkarte „API-Schlüssel“ Ihrer ThingSpeak Kanalansicht. Speichern Sie den API-Schlüssel Ihres Kanals zur Vereinfachung in einer Variablen.

Beispiel: thingSpeakRead(12397,'WriteKey','XXXXXXXXXXXXXXXX');

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: thingSpeakWrite(17504,[1.1,2.2],'Fields',[1,2,3],'WriteKey','channel write api key');

Fields — Kanalfelder

numerisch

Kanalfeld-IDs, angegeben als durch Kommas getrenntes Paar bestehend aus 'Fields' und einem 1-mal-n-positiven Ganzzahlwert.

Beispiel: thingSpeakWrite(17504,[2.3,1.2,3.2,0.1],'Fields',[1,2,3,4],'WriteKey','channel write api key');

Values — Datenwerte

numerisch | Array | Tisch | Zeitplan

Datenwerte, angegeben als durch Kommas getrenntes Paar bestehend aus 'Values' und numerischen Skalaren, numerischen Vektoren, einem Zellenarray, einer Zeichenfolge von Zellenarrays, Tabellen- oder Stundenplanwerten. Geben Sie die Daten an, die in die durch den Parameter 'Fields' angegebenen Kanalfelder geschrieben werden sollen.

Beispiel: thingSpeakWrite(17504,'Fields',[1,3,4],'Values',[1,2,3],'WriteKey','channel write api key');

Location — Positionsinformationen von Daten

numerisch

Positionsinformationen der Daten im Kanal, angegeben als durch Kommas getrenntes Paar bestehend aus 'Location' und einem numerischen Array. Zu den Standortinformationen gehören Breitengrad, Längengrad und Höhe. In diesem Beispiel werden für jeden der drei in Feld 1 bereitgestellten Punkte dieselben Standortinformationen geschrieben.

Beispiel: thingSpeakWrite(17504,[2.3,1.2,3.2,0.1],'Location',[-40,23,200],'WriteKey',' write api key');

Timeout — Timeout-Zeitraum für die Serververbindung

10 (Standardeinstellung) | numerisch

Timeout-Zeitraum für die Serververbindung, angegeben als durch Kommas getrenntes Paar bestehend aus 'TimeOut' und einem numerischen Wert. Der Timeout-Zeitraum ist die Anzahl der Sekunden, die thingSpeakRead für die Verbindung mit dem Server zur Verfügung steht, bevor die Anfrage beendet wird.

Beispiel: thingSpeakWrite(17504,[2.3,1.2,3.2,0.1],'WriteKey','write API key','Timeout',15);

Timestamp — Zeitstempel der Datenwerte

Terminzeit

Zeitstempel der in Felder im Schreibkanal geschriebenen Datenwerte, angegeben als durch Kommas getrenntes Paar bestehend aus 'Timestamp' und einem Wert. Der Wert muss ein MATLAB^® datetime- Wert sein. Alle Zeitstempel müssen eindeutig sein. Wenn Sie doppelte Zeitstempel einreichen, werden alle Ihre Aktualisierungen abgelehnt. Andernfalls werden nur Aktualisierungen mit Zeitstempeln, die sich bereits im Kanal befinden, abgelehnt.

Hinweis

Geben Sie 'Timestamp' nicht an, wenn Sie 'Values' als Stundenplan angegeben haben.

Beispiel: thingSpeakWrite(17504,[2.3,1.2,3.2,0.1],'WriteKey','channel write api key','Timestamp',[datetime('2/6/2018 9:27:12','format','MM/dd/uuuu HH:mm:ss')]);

Datentypen: datetime

Ausgabeargumente

response — Kanalantwort des Schreibvorgangs

Struktur

Kanalantwort des Schreibvorgangs, zurückgegeben als Struktur mit Feldern in der in der Tabelle gezeigten Reihenfolge. Die Felder der Struktur geben die Werte an, die in die Felder des Kanals geschrieben werden:

Feld	Beschreibung
FieldX	FieldX-Daten für den Eintrag, bis zu acht Felder
Latitude	Breitengrad für den Schreibvorgang
Longitude	Längengrad für den Schreibvorgang
Channel ID	Kanalidentifikationsnummer
Created	Datum/Uhrzeit des Schreibvorgangs und Feed-Eintrags
Last EntryID	Eintrags-ID für das letzte Kanalupdate
Created	Datetime des Erstellungsdatums des Kanals
Updated	Datum und Uhrzeit der letzten Änderung der Kanaleinstellungen
Last EntryID	Eintrags-ID für das letzte Kanalupdate
Altitude	Höhe für den Schreibvorgang

Einschränkungen

• Alle Zeitstempel müssen eindeutig sein. Sie können keine neuen Daten mit Zeitstempeln schreiben, die mit vorhandenen Daten im Kanal übereinstimmen.

• Die zulässige Aktualisierungshäufigkeit für einen Kanal ist abhängig von Ihrem Lizenztyp begrenzt. Spezifische Informationen finden Sie unter Frequently Asked Questions und How to Buy . Aktualisierungen mit mehreren Einträgen, etwa in einer Tabelle oder einem Stundenplan, sind auf die langsamere Aktualisierungsfrequenz beschränkt. Für Benutzer kostenloser Konten ist die Anzahl der Nachrichten in einem einzelnen Anruf an thingSpeakWrite auf 960 Nachrichten begrenzt. Für Nutzer kostenpflichtiger Konten liegt die Grenze bei 14.400 Nachrichten. Versuche, mit einer Geschwindigkeit zu veröffentlichen, die über dem zulässigen Grenzwert liegt, geben die folgende Fehlermeldung zurück: Anfragen kommen zu häufig. Weitere Informationen finden Sie unter Einschränkungen in der Dokumentation.

Mehr über

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

• thingSpeakRead | webwrite (MATLAB)