thingSpeakRead
Leer datos almacenados en ThingSpeak canal
Sintaxis
Descripción
lee los datos más recientes de todos los campos del canal público especificado en ThingSpeak.com y devuelve los datos como un tipo numérico.data
= thingSpeakRead(channelID
)
utiliza opciones adicionales especificadas por uno o más data
= thingSpeakRead(channelID
,Name=Value
)Name=Value
argumentos de par. Para leer datos no numéricos, debe especificar 'OutputFormat'
.
[
también devuelve marcas de tiempo del canal especificado en ThingSpeak.com y puede incluir cualquiera de los argumentos de entrada en las sintaxis anteriores.data
,timestamps
] = thingSpeakRead(___)
[
también devuelve información del canal.data
,timestamps
,channelInfo
] = thingSpeakRead(___)
Ejemplos
Recuperar tres puntos de datos de un canal en un horario
Lea los últimos tres puntos de datos de los campos 1 y 4 de un canal público y devuelva los datos a un calendario.
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
Recuperar cinco minutos de datos de un canal en un horario
Lea los últimos cinco minutos de datos de los campos 1 y 4 de un canal público y devuelva los datos a una tabla.
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.
Recuperar datos recientes con su marca de tiempo
Lea el resultado más reciente de todos los campos de un canal público, incluida la marca de tiempo.
[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
Recupere cinco minutos de datos con marcas de tiempo e información del canal
Lea los últimos cinco minutos de datos de los campos 1 y 4 de un canal público, incluidas las marcas de tiempo y la información del canal.
[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?'
Recuperar datos de un rango de fechas específico
Lea los datos desde las 11:59:01 del 9 de agosto de 2018 hasta las 12:02:52 del 10 de agosto de 2018 para los campos 1 y 4 de un canal público, incluidas las marcas de tiempo y la información del canal.
[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?'
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. Para canales privados, también debe especificar el argumento ReadKey
.
Tipos de datos: double
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: thingSpeakRead(12397,Location=true);
thingSpeakRead(12397,'Location',true);
DateRange
— Rango de tiempo para los datos recopilados
vector de fecha y hora
Intervalo de tiempo para que se devuelvan los datos recopilados, especificado como un par nombre-valor que consta de 'DateRange'
y una matriz de valores que tienen [startdate,enddate]
en MATLAB® datetime
(MATLAB) valores. El servidor ThingSpeak limita el número de puntos devueltos a un máximo de 8000. Ajuste sus rangos o realice múltiples llamadas si necesita más de 8000 puntos de datos.
Nota
No puedes usar DateRange
con NumDays
o NumMinutes
.
Ejemplo: thingSpeakRead(12397,DateRange=[datetime('Aug 8, 2014'),datetime('Aug 12, 2014')]);
Fields
— Campos de canal
escalar numérico positivo
ID de campo de canal, especificados como un par de nombre-valor que consta de Fields
y valores numéricos del ID de campo de canal del que recuperar datos.
Ejemplo: thingSpeakRead(12397,Fields=[1,3,4]);
Location
— Información posicional de datos.
lógico
Indicador para mostrar información posicional de los datos del canal, especificado como un par nombre-valor que consta de Location
y un valor lógico. La información de ubicación incluye latitud, longitud y altitud.
Ejemplo: thingSpeakRead(12397,Location=true);
NumDays
— Número de días de datos
escalar numérico positivo
Número de días de datos de los que extraer datos, especificados como un par nombre-valor que consta de 'NumDays'
y un valor numérico. El número de días se mide en períodos de 24 horas. El servidor ThingSpeak limita el número de puntos devueltos a un máximo de 8000. Ajuste su número de días o realice varias llamadas si necesita más de 8000 puntos de datos.
Nota
No puedes usar NumDays
con DateRange
o NumMinutes
.
Ejemplo: thingSpeakRead(12397,NumDays=2);
NumMinutes
— Número de minutos de datos
escalar numérico positivo
Número de minutos de datos de los que extraer datos, especificados como un par nombre-valor que consta de 'NumMinutes'
y un valor numérico. La cantidad de minutos de datos que se recuperarán se mide desde el momento en que se emite el comando. El servidor ThingSpeak limita el número de puntos devueltos a un máximo de 8000. Ajuste su cantidad de minutos o realice varias llamadas si necesita más de 8000 puntos de datos.
Nota
No puedes usar NumMinutes
con DateRange
o NumDays
.
Ejemplo: thingSpeakRead(12397,NumMinutes=20);
Tipos de datos: double
NumPoints
— Número de puntos de datos
escalar numérico positivo
Número de puntos de datos para extraer, especificados como un par nombre-valor que consta de 'NumPoints'
y un valor numérico. El número de puntos o filas de datos se cuenta desde el momento en que se emite el comando. El servidor ThingSpeak limita el número de puntos devueltos a un máximo de 8000.
Ejemplo: thingSpeakRead(12397,NumPoints=200);
OutputFormat
— Clase de los datos de salida
matriz (predeterminado) | tabla | calendario
Clase de los datos de salida, especificada como un par separado por comas que consta de 'OutputFormat'
y un valor de texto. Los valores válidos son 'matrix'
, 'table'
y 'timetable'
. Utilice el formato 'matrix'
para datos numéricos. Puede utilizar 'timetable'
o 'table'
para cualquier dato no numérico. El formato 'table'
genera [data,channelInfo]
, donde data
contiene las marcas de tiempo y los datos de los campos del canal. El formato 'timetable'
genera [data,channelInfo]
, donde data
es un cronograma y contiene tantas variables como el número de 'fields'
solicitados. .
Ejemplo: thingSpeakRead(12397,OutputFormat='table');
Ejemplo: thingSpeakRead(12397,OutputFormat='timetable');
ReadKey
— Leer la clave API del canal
vector de caracteres de la clave API | escalar de cadena de clave API
Lectura de la clave API del canal, especificada como un par nombre-valor que consta de 'ReadKey'
y un vector de caracteres que representa una clave API leída del canal. La clave Read API le permite leer datos de un canal privado. Puede encontrar la clave Leer API para un canal en la pestaña Claves API de la vista de su canal ThingSpeak. Si está leyendo datos de un canal público, no necesita una clave API de lectura. Guarde la clave API de lectura de su canal en una variable para mayor comodidad.
Ejemplo: thingSpeakRead(12397,ReadKey='F6CSCVKX42WFZN9Y');
Tipos de datos: char
Timeout
— Periodo de tiempo de espera de la conexión del servidor
10 (predeterminado) | escalar numérico positivo
Período de tiempo de espera de la conexión del servidor, especificado como un par nombre-valor que consta de 'Timeout'
y un valor numérico. El valor es la cantidad de segundos permitidos para que thingSpeakRead
se conecte al servidor.
Ejemplo: thingSpeakRead(12397,Timeout=15);
Argumentos de salida
data
— datos del canal
formación (predeterminado) | tabla | calendario
Datos del canal, devueltos como una matriz, tabla o horario.
timestamps
— Marca de tiempo de cada elemento de datos.
formación (predeterminado)
Marca de tiempo de cada elemento de datos, devuelta como una matriz de valores datetime
.
Tipos de datos: datetime
channelInfo
— Información del canal
estructura
Información del canal, devuelta como una estructura con campos en el orden que se muestra en la tabla.
Campo | Descripción |
---|---|
ChannelID | Número de identificación del canal |
Name | Nombre del canal |
Description | descripción del canal |
Latitude | Latitud para el canal según lo dispuesto en la configuración del canal |
Longitude | Longitud del canal según lo dispuesto en la configuración del canal |
Altitude | Elevación del canal según lo dispuesto en la configuración 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 |
Field Descriptions | Lista de nombres de campos |
Field IDs | Lista de campos habilitados |
URL | URL para datos del feed |
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
Comando de MATLAB
Ha hecho clic en un enlace que corresponde a este comando de MATLAB:
Ejecute el comando introduciéndolo en la ventana de comandos de MATLAB. Los navegadores web no admiten comandos de MATLAB.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)