Cette page a été traduite par traduction automatique. Cliquez ici pour voir la dernière version en anglais.

thingSpeakWrite

Écrire des données sur le canal ThingSpeak

Syntaxe

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

thingSpeakWrite(___,Name,Value)

response = thingSpeakWrite(___)

Description

thingSpeakWrite(channelID,data,'WriteKey','channel write API key') écrit les données sur le canal spécifié. La clé d'API en écriture est spécifiée sous la forme d'une paire séparée par des virgules composée de 'WriteKey' et d'un vecteur de caractères ou chaîne de caractère représentant la clé en écriture du canal.

thingSpeakWrite(___,Name,Value) utilise des options supplémentaires spécifiées par un ou plusieurs arguments de paire Name,Value.

response = thingSpeakWrite(___) renvoie la réponse fournie par le serveur ThingSpeak™ une fois l'opération d'écriture réussie.

Exemples

Écrire des données sur un canal ThingSpeak

Écrivez une seule valeur numérique dans le champ 1 d'un canal.

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

Écrire plusieurs valeurs et afficher la réponse

Écrivez des valeurs numériques dans les quatre premiers champs consécutifs [1,2,3,4] d'un canal.

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

Écrire des données non numériques

Écrivez des données non numériques dans les trois premiers champs consécutifs [1,2,3] d'un canal.

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

Écrire des données mixtes

Écrire des valeurs mixtes dans des champs non consécutifs [1,4,6] d'un canal.

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

Écrire les données de champ et d'emplacement

Mettez à jour trois champs et écrivez les données de latitude, de longitude et d'altitude pour l'entrée.

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

Écrire uniquement les données de localisation

Écrivez des données de latitude, de longitude et d'altitude dans un canal sans ajouter de valeurs aux champs.

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

Écrire des données avec horodatage

Écrivez un horodatage pour la valeur en cours d'écriture sur un canal. L'horodatage fourni est interprété comme l'heure locale.

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

Écrire une matrice de données

Écrivez une matrice de données dans les trois premiers champs d'un canal. Les horodatages fournis sont interprétés comme l'heure locale.

% 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)

Écrire un calendrier de données

Écrivez une timetable de données dans les deux premiers champs d'un canal. Les horodatages fournis sont interprétés comme l'heure locale.

% 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)

Arguments d'entrée

channelID — Numéro d'identification du canal

numérique

Numéro d'identification du canal , spécifié sous la forme d'un entier positif.

data — Données à écrire dans le canal

déployer | numérique | tableau | timetable

Données à écrire dans canal, spécifiées sous la forme d'un scalaire numérique ou d'un vecteur numérique, d'un cell array, d'une chaîne de caractère de tableaux de cellules, d'une table ou d'une timetable. Si vous spécifiez des données scalaires, la valeur est écrite dans le premier champ du canal (Champ 1). Pour un vecteur ou un cell array 1-D , les données sont écrites dans des champs consécutifs commençant par Champ 1.

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

channel write API key — clé d'API en écriture du canal

vecteur de caractères de la clé API | scalaire de chaîne de caractère de la clé API

clé d'API en écriture du canal , spécifiée sous la forme d'une paire séparée par des virgules composée de 'WriteKey' et d'un vecteur de caractères représentant la clé d'API en écriture du canal . La clé d'API en écriture est requise pour écrire des données dans un canal. Vous pouvez trouver la clé d'API en écriture d'un canal dans l'onglet Clés d'API de votre vue des canaux ThingSpeak . Enregistrez votre clé d'API en écriture de canal dans une variable pour plus de commodité.

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

Arguments nom-valeur

Spécifiez des paires d'arguments facultatives sous la forme Name1=Value1,...,NameN=ValueN, où Name est le nom de l'argument et Value est la valeur correspondante. Les arguments nom-valeur doivent apparaître après les autres arguments, mais l'ordre des paires n'a pas d'importance.

Avant R2021a, utilisez des virgules pour séparer chaque nom et valeur, et mettez Name entre guillemets.

Exemple : thingSpeakWrite(17504,[1.1,2.2],'Fields',[1,2,3],'WriteKey','channel write api key');

Fields — Champs de canal

numérique

ID de champs de canal, spécifiés sous la forme d'une paire séparée par des virgules composée de 'Fields' et d'une valeur entière positive 1 par n.

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

Values — Valeurs des données

numérique | déployer | tableau | timetable

Valeurs de données, spécifiées sous la forme d'une paire séparée par des virgules composée de 'Values' et d'un scalaire numérique, d'un vecteur numérique, d'un cell array, d'une chaîne de caractère de tableaux de cellules, d'un tableau ou de valeurs de timetable . Spécifiez les données à écrire dans les champs de canal spécifiés par le paramètre 'Fields'.

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

Location — Informations de position des données

numérique

Informations de position des données dans le canal, spécifiées sous la forme d'une paire séparée par des virgules composée de 'Location' et d'un tableau numérique. Les informations de localisation incluent la latitude, la longitude et l'altitude. Cet exemple écrit les mêmes informations de localisation pour chacun des trois points fournis dans le champ 1.

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

Timeout — Délai d'expiration de la connexion au serveur

dix (par défaut) | numérique

Délai d'expiration de la connexion au serveur, spécifié sous la forme d'une paire séparée par des virgules composée de 'TimeOut' et d'une valeur numérique. Le délai d'attente est le nombre de secondes accordées à thingSpeakRead pour se connecter au serveur avant la fin de la requête.

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

Timestamp — Horodatage des valeurs de données

date-heure

Horodatage des valeurs de données écrites dans les champs du canal d'écriture, spécifié sous la forme d'une paire séparée par des virgules composée de 'Timestamp' et d'une valeur. La valeur doit être une valeur MATLAB^® datetime. Tous les horodatages doivent être uniques. Si vous soumettez des horodatages en double, toutes vos mises à jour sont rejetées, sinon seules les mises à jour avec des horodatages déjà dans le canal sont rejetées.

Remarque

Ne spécifiez pas 'Timestamp' si vous avez spécifié 'Values' comme timetable.

Exemple : 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')]);

Types de données : datetime

Arguments de sortie

response — Réponse de canal de l'opération d'écriture

structure

Réponse de canal de l'opération d'écriture, renvoyée sous forme de structure avec des champs dans l'ordre indiqué dans le tableau. Les champs de la structure indiquent les valeurs écrites dans les champs du canal:

Champ	Description
FieldX	Données FieldX pour l'entrée, jusqu'à huit champs
Latitude	Latitude pour l'opération d'écriture
Longitude	Longitude pour l'opération d'écriture
Channel ID	Numéro d'identification du canal
Created	Date/heure de l'opération d'écriture et de l'entrée du flux
Last EntryID	ID d'entrée pour la mise à jour de canal la plus récente
Created	Datetime de la date de création du canal
Updated	Date/heure à laquelle les paramètres des canaux ont été modifiés pour la dernière fois
Last EntryID	ID d'entrée pour la mise à jour de canal la plus récente
Altitude	Altitude pour l'opération d'écriture

Limites

• Tous les horodatages doivent être uniques. Vous ne pouvez pas écrire de nouvelles données avec des horodatages qui correspondent aux données existantes dans le canal.

• La fréquence de mise à jour autorisée pour un canal est limitée en fonction de votre type de licence. Voir Frequently Asked Questions et How to Buy pour des informations spécifiques. Les mises à jour avec plusieurs entrées, comme dans un tableau ou une timetable, sont limitées à la fréquence de mise à jour la plus lente. Pour les utilisateurs de comptes gratuits, le nombre de messages en un seul appel vers thingSpeakWrite est limité à 960 messages. Pour les utilisateurs de comptes payants, la limite est de 14 400 messages. Les tentatives de publication à un rythme plus rapide que la limite autorisée renverront l'erreur suivante : Les requêtes sont trop fréquentes. Pour plus d'informations, voir Limitations dans la documentation.

En savoir plus

ThingSpeak

ThingSpeak est un service de plateforme d'analyse IoT qui vous permet d'agréger, de visualiser et d'analyser des flux de données temps réel dans le cloud. Voir License Options et Commercial Use pour plus d'informations.

Historique des versions

Introduit dans R2019a

Voir aussi

Fonctions

• thingSpeakRead | webwrite (MATLAB)