Main Content

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

thingSpeakRead

Leer datos almacenados en ThingSpeak canal

Desde R2019a

contraer todo en la página

Sintaxis

data = thingSpeakRead(channelID)
data = thingSpeakRead(channelID,Name=Value)
data = thingSpeakRead(___,ReadKey='channel Read API key')
[data,timestamps] = thingSpeakRead(___)
[data,timestamps,channelInfo] = thingSpeakRead(___)

Descripción

ejemplo

data = thingSpeakRead(channelID) 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.

ejemplo

data = thingSpeakRead(channelID,Name=Value) utiliza opciones adicionales especificadas por uno o más pares de argumentos Name=Value. Para leer datos no numéricos, debe especificar el 'OutputFormat'.

ejemplo

data = thingSpeakRead(___,ReadKey='channel Read API key') usa el ThingSpeak™ Lea la clave API para leer desde un canal privado.

ejemplo

[data,timestamps] = thingSpeakRead(___) también devuelve marcas de tiempo del canal especificado en thingspeak.com y puede incluir cualquiera de los argumentos de entrada en sintaxis anteriores.

ejemplo

[data,timestamps,channelInfo] = thingSpeakRead(___) también devuelve información del canal.

Ejemplos

contraer todo

Lea los últimos tres puntos de datos de los campos 1 y 4 de un canal público y devuelva los datos a un horario.

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

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.

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

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?'

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

contraer todo

El número de identificación del canal, especificado como un entero positivo. Para canales privados, también debe especificar el ReadKey argumento.

Tipos de datos: double

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: thingSpeakRead(12397,Location=true); thingSpeakRead(12397,'Location',true);

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. ThingSpeak servidor limita el número de puntos devueltos a un máximo de 8000. Ajuste sus rangos o haga varias llamadas si necesita más de 8000 puntos de datos.

Nota

No se puede utilizar DateRange con NumDays o NumMinutes.

Ejemplo: thingSpeakRead(12397,DateRange=[datetime('Aug 8, 2014'),datetime('Aug 12, 2014')]);

ID de campo de canal, especificados como un par de nombre y valor que consta de Fields y valores numéricos del ID de campo del canal para recuperar datos.

Ejemplo: thingSpeakRead(12397,Fields=[1,3,4]);

Indicador para mostrar información de posición de los datos del canal, especificados 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);

Número de días de datos para extraer datos, especificado como un par de nombre-valor que consiste en 'NumDays' y un valor numérico. El número de días se mide en períodos de 24 horas. los ThingSpeak servidor 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 se puede utilizar NumDays con DateRange o NumMinutes.

Ejemplo: thingSpeakRead(12397,NumDays=2);

Número de minutos de datos para extraer datos, especificado como un par de nombre-valor que consiste en 'NumMinutes' y un valor numérico. El número de minutos de datos para recuperar se mide desde el momento en que se emite el comando. los ThingSpeak servidor limita el número de puntos devueltos a un máximo de 8000. Ajuste su número de minutos o haga varias llamadas si necesita más de 8000 puntos de datos.

Nota

No se puede utilizar NumMinutes con DateRange o NumDays.

Ejemplo: thingSpeakRead(12397,NumMinutes=20);

Tipos de datos: double

Número de puntos de datos para extraer, especificado como un par de 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. los ThingSpeak servidor limita el número de puntos devueltos a un máximo de 8000.

Ejemplo: thingSpeakRead(12397,NumPoints=200);

Clase de los datos de salida, especificados como un par separado por comas que consta de 'OutputFormat' y un valor de texto. Los valores válidos son 'matrix' , 'table' , y 'timetable'. Usar 'matrix' Formato para datos numéricos. Puedes usar 'timetable' o 'table' para cualquier dato no numérico. los 'table' salidas de formato [data,channelInfo] , dónde data contiene las marcas de tiempo y los datos de los campos del canal. los 'timetable' salidas de formato [data,channelInfo] , dónde data es un horario y contiene tantas variables como el número de pedidos 'fields'.

Ejemplo: thingSpeakRead(12397,OutputFormat='table');

Ejemplo: thingSpeakRead(12397,OutputFormat='timetable');

Lea la clave API del canal, especificada como un par de nombre y valor que consta de 'ReadKey' y un vector de caracteres que representa una clave API de lectura de canal. La clave de API de lectura le permite leer datos de un canal privado. Puede encontrar la clave de API de lectura para un canal en la pestaña Claves de API de su vista de canal de 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

Período de tiempo de espera de la conexión del servidor, especificado como un par de nombre y valor que consta de 'Timeout' y un valor numérico. El valor es el número de segundos permitidos para thingSpeakRead para conectarse al servidor.

Ejemplo: thingSpeakRead(12397,Timeout=15);

Argumentos de salida

contraer todo

Datos del canal, devueltos como una matriz, una tabla o un horario.

Marca de tiempo de cada elemento de datos, devuelto como una matriz de datetime valores.

Tipos de datos: datetime

Información del canal, devuelta como una estructura con campos en el orden que se muestra en la tabla.

CampoDescripción
ChannelID

Número de identificación del canal

Name

nombre del canal

Description

descripción del canal

Latitude

Latitud para el canal tal como se proporciona en la configuración del canal

Longitude

Longitud del canal tal como se proporciona en la configuración del canal

Altitude

Elevación para el canal como se proporciona en la configuración del canal

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

Field Descriptions

Lista de nombres de campo

Field IDs

Lista de campos habilitados

URL

URL para datos de feed

Más acerca de

contraer todo

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