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

thingSpeakWrite

Escribir datos en ThingSpeak canal

Desde R2019a

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 Write API se especifica como un par separado por comas que consta de 'WriteKey' y un vector de caracteres o cadena que representa la clave de escritura del canal.

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

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

Ejemplos

Escribir datos en un canal de ThingSpeak

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

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

Escribir valores múltiples y ver 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 los 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 la 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 la 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 calendario de datos

Escriba un calendario de datos en los dos primeros campos de un canal. Las marcas de tiempo proporcionadas se interpretan como la 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 horario. 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 que comienzan con el Campo 1.

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

channel write API key — Escribir la 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 API de escritura 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 la clave API de escritura de su canal en una variable para mayor comodidad.

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

Argumentos de par nombre-valor

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

Antes de R2021a, use comas para separar cada nombre y valor, y adjunte 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 escalar numérico, vector numérico, una matriz de celdas, una cadena de matrices de celdas, una tabla o valores de horario. Especifique los datos que se escribirán en los campos de canal especificados por el 'Fields' parámetro.

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 de posición de los datos en el canal, especificada como un par separado por comas que consta de 'Location' y 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 provistos en el campo 1.

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

Timeout — Período de tiempo de espera de conexión del servidor

10 (predeterminado) | numérico

Período de tiempo de espera de conexión del servidor, especificado como un par separado por comas que consta de 'TimeOut' y un valor numérico. El tiempo de espera es el número de segundos permitidos para thingSpeakRead para conectarse 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 valores de datos

fecha y hora

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

Nota

No especificar 'Timestamp' si has 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 de 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 de FieldX para la entrada, hasta ocho campos
Latitude	Latitud para la operación de escritura
Longitude	Longitud de 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 la entrada del feed
Last EntryID	ID de entrada para la actualización de canal más reciente
Created	Fecha y hora de la fecha de creación del canal
Updated	Fecha y hora en que se cambió la configuración de los canales por última vez
Last EntryID	ID de entrada para la actualización de canal más reciente
Altitude	Elevación para la operación de escritura

Limitaciones

• Todas las marcas de tiempo deben ser únicas. No puede escribir nuevos datos 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. Ver Preguntas frecuentes y Cómo comprar para información específica. Las actualizaciones con varias entradas, como en una tabla o un horario, 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á limitado 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. Ver Opciones de licencia y el Uso comercial para más información.

Historial de versiones

Introducido en R2019a

Consulte también

Funciones

• thingSpeakRead | webwrite (MATLAB)

×

Abrir ejemplo

Tiene una versión modificada de este ejemplo. ¿Desea abrir este ejemplo con sus modificaciones?

No, sobrescribir la versión modificada Sí