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

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

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.

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

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

[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 las sintaxis anteriores.

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

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

Consulte también

Funciones

• thingSpeakWrite | webread (MATLAB)