Esta página se ha traducido mediante traducción automática. Haga clic aquí para ver la última versión en inglés.

thingSpeakWrite

Escribir datos en el canal ThingSpeak

Sintaxis

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

thingSpeakWrite(___,Name,Value)

response = thingSpeakWrite(___)

Descripción

thingSpeakWrite(channelID,data,'WriteKey','channel write API key') escribe los datos en el canal especificado. La clave de escritura de API se especifica como un par separado por comas que consta de 'WriteKey' y un vector de caracteres o una cadena que representa la clave de escritura del canal.

thingSpeakWrite(___,Name,Value) utiliza opciones adicionales especificadas por uno o más Name,Value argumentos de par.

response = thingSpeakWrite(___) devuelve la respuesta proporcionada por el servidor ThingSpeak™ al completar exitosamente la operación de escritura.

Ejemplos

Escribir datos en un canal ThingSpeak

Escriba un único valor numérico en el campo 1 de un canal.

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

Escriba varios valores y vea la respuesta

Escriba valores numéricos en los primeros cuatro campos consecutivos [1,2,3,4] de un canal.

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

Escribir datos no numéricos

Escriba datos no numéricos en los primeros tres campos consecutivos [1,2,3] de un canal.

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

Escribir datos mixtos

Escriba valores mixtos en campos no consecutivos [1,4,6] de un canal.

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

Escribir datos de campo y ubicación

Actualice tres campos y escriba datos de latitud, longitud y altitud para la entrada.

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

Escribir solo datos de ubicación

Escriba datos de latitud, longitud y altitud en un canal sin agregar valores a los campos.

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

Escribir datos con marca de tiempo

Escriba una marca de tiempo para el valor que se escribe en un canal. La marca de tiempo proporcionada se interpreta como hora local.

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

escribir una matriz de datos

Escriba una matriz de datos en los primeros tres campos de un canal. Las marcas de tiempo proporcionadas se interpretan como hora local.

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

Escribir un cronograma de datos

Escriba un calendario de datos en los dos primeros campos de un canal. Las marcas de tiempo proporcionadas se interpretan como hora local.

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

Argumentos de entrada

channelID — Número de identificación del canal

numérico

El número de identificación del canal, especificado como un entero positivo.

data — Datos para escribir en el canal.

formación | numérico | tabla | calendario

Datos para escribir en el canal, especificados como un escalar numérico o un vector numérico, una matriz de celdas, una cadena de matrices de celdas, una tabla o un calendario. Si especifica datos escalares, el valor se escribe en el primer campo del canal (Campo 1). Para un vector o una matriz de celdas 1-D, los datos se escriben en campos consecutivos comenzando con el Campo 1.

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

channel write API key — Escribir clave API del canal

vector de caracteres de la clave API | escalar de cadena de clave API

Escriba la clave API del canal, especificada como un par separado por comas que consta de 'WriteKey' y un vector de caracteres que representa la clave API de escritura del canal. Se requiere la clave Write API para escribir datos en un canal. Puede encontrar la clave API de escritura para un canal en la pestaña Claves API de la vista de su canal ThingSpeak. Guarde su canal. Escriba la clave API en una variable para mayor comodidad.

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

Argumentos de par nombre-valor

Especifique pares de argumentos opcionales como Name1=Value1,...,NameN=ValueN, donde Name es el nombre del argumento y Value es el valor correspondiente. Los argumentos nombre-valor deben aparecer después de otros argumentos, pero el orden de los pares no importa.

Antes de R2021a, utilice comas para separar cada nombre y valor, y encierre Name entre comillas.

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

Fields — Campos de canal

numérico

ID de campos de canal, especificados como un par separado por comas que consta de 'Fields' y un valor entero positivo de 1 por n.

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

Values — Valores de datos

numérico | formación | tabla | calendario

Valores de datos, especificados como un par separado por comas que consta de 'Values' y un escalar numérico, un vector numérico, una matriz de celdas, una cadena de matrices de celdas, una tabla o valores de calendario. Especifique los datos que se escribirán en los campos del canal especificados por el parámetro 'Fields' .

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

Location — Información posicional de datos.

numérico

Información posicional de los datos en el canal, especificada como un par separado por comas que consta de 'Location' y una matriz numérica. La información de ubicación incluye latitud, longitud y altitud. Este ejemplo escribe la misma información de ubicación para cada uno de los tres puntos proporcionados en el campo 1.

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

Timeout — Periodo de tiempo de espera de la conexión del servidor

10 (predeterminado) | numérico

Período de tiempo de espera de la conexión del servidor, especificado como un par separado por comas que consta de 'TimeOut' y un valor numérico. El período de tiempo de espera es la cantidad de segundos permitidos para que thingSpeakRead se conecte al servidor antes de que finalice la solicitud.

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

Timestamp — Marca de tiempo de los valores de datos

fecha y hora

Marca de tiempo de los valores de datos escritos en campos del canal de escritura, especificados como un par separado por comas que consta de 'Timestamp' y un valor. El valor debe ser un valor MATLAB^® datetime . Todas las marcas de tiempo deben ser únicas. Si envía marcas de tiempo duplicadas, se rechazarán todas sus actualizaciones; de lo contrario, solo se rechazarán las actualizaciones con marcas de tiempo que ya estén en el canal.

Nota

No especifique 'Timestamp' si ha especificado 'Values' como horario.

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

Tipos de datos: datetime

Argumentos de salida

response — Respuesta del canal de la operación de escritura.

estructura

Respuesta del canal de la operación de escritura, devuelta como una estructura con campos en el orden que se muestra en la tabla. Los campos de la estructura indican los valores escritos en los campos del canal:

Campo	Descripción
FieldX	Datos FieldX para la entrada, hasta ocho campos
Latitude	Latitud para la operación de escritura.
Longitude	Longitud para la operación de escritura.
Channel ID	Número de identificación del canal
Created	Fecha y hora de la operación de escritura y entrada del feed
Last EntryID	ID de entrada para la actualización más reciente del canal
Created	Fecha y hora de la fecha de creación del canal.
Updated	Fecha y hora en la que se cambiaron por última vez las configuraciones de los canales
Last EntryID	ID de entrada para la actualización más reciente del canal
Altitude	Elevación para la operación de escritura.

Limitaciones

• Todas las marcas de tiempo deben ser únicas. No puede escribir datos nuevos con marcas de tiempo que coincidan con los datos existentes en el canal.

• La frecuencia de actualización permitida para un canal está limitada según su tipo de licencia. Consulte Frequently Asked Questions y How to Buy para obtener información específica. Las actualizaciones con múltiples entradas, como en una tabla o calendario, se limitan a la frecuencia de actualización más lenta. Para usuarios de cuentas gratuitas, la cantidad de mensajes en una sola llamada a thingSpeakWrite está limitada a 960 mensajes. Para usuarios de cuentas pagas, el límite es de 14.400 mensajes. Los intentos de publicar a una velocidad superior al límite permitido devolverán el siguiente error: Las solicitudes son demasiado frecuentes. Para obtener más información, consulte Limitaciones en la documentación.

Más acerca de

thingspeak

ThingSpeak es un servicio de plataforma de análisis de IoT que le permite agregar, visualizar y analizar flujos de datos en vivo en la nube. Consulte License Options y Commercial Use para obtener más información.

Historial de versiones

Introducido en R2019a

Consulte también

Funciones

• thingSpeakRead | webwrite (MATLAB)