Cette page a été traduite par traduction automatique. Cliquez ici pour voir la dernière version en anglais.

thingSpeakRead

Lire les données stockées dans le canal ThingSpeak

réduire tous les éléments de la page

Syntaxe

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

Description

data = thingSpeakRead(channelID) lit les données les plus récentes de tous les champs du canal public spécifié sur ThingSpeak.com et renvoie les données sous forme numérique.

exemple

data = thingSpeakRead(channelID,Name=Value) utilise des options supplémentaires spécifiées par un ou plusieurs arguments de paire Name=Value. Pour lire des données non numériques, vous devez spécifier le 'OutputFormat'.

exemple

data = thingSpeakRead(___,ReadKey='channel Read API key') utilise la clé d'API ThingSpeak™ Read pour lire à partir d'un canal privé.

exemple

[data,timestamps] = thingSpeakRead(___) renvoie également les horodatages du canal spécifié sur ThingSpeak.com et peut inclure n'importe lequel des arguments d'entrée dans les syntaxes précédentes.

exemple

[data,timestamps,channelInfo] = thingSpeakRead(___) renvoie également des informations sur le canal .

exemple

Exemples

réduire tout

Lire les trois derniers points de données des champs 1 et 4 d'un canal public, et retourner les données dans une timetable.

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

Lisez les cinq dernières minutes de données des champs 1 et 4 d'un canal public et renvoyez les données dans un tableau.

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.

Lire le résultat le plus récent pour tous les champs d'un canal public , y compris l'horodatage.

[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

Lisez les cinq dernières minutes de données des champs 1 et 4 d'un canal public, y compris les horodatages et les informations sur le 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?'

Lisez les données de 11:59:01 le 9 août 2018 à 12:02:52 le 10 août 2018 pour les champs 1 et 4 d'un canal public, y compris les horodatages et les informations sur le 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?'

Arguments d'entrée

réduire tout

Numéro d'identification du canal , spécifié sous la forme d'un entier positif. Pour les canaux privés, vous devez également spécifier l'argument ReadKey.

Types de données : double

Arguments nom-valeur

réduire tout

Spécifiez des paires d'arguments facultatives sous la forme Name1=Value1,...,NameN=ValueN, où Name est le nom de l'argument et Value est la valeur correspondante. Les arguments nom-valeur doivent apparaître après les autres arguments, mais l'ordre des paires n'a pas d'importance.

Avant R2021a, utilisez des virgules pour séparer chaque nom et valeur, et mettez Name entre guillemets.

Exemple : thingSpeakRead(12397,Location=true); thingSpeakRead(12397,'Location',true);

Plage de temps de retour des données collectées, spécifiée sous la forme d'une paire nom-valeur composée de 'DateRange' et d'un tableau de valeurs qui ont [startdate,enddate] dans MATLAB® datetime (MATLAB) valeurs. Le serveur ThingSpeak limite le nombre de points restitués à un maximum de 8000. Ajustez vos plages ou faites plusieurs appels si vous avez besoin de plus de 8000 points de données.

Remarque

Vous ne pouvez pas utiliser DateRange avec NumDays ou NumMinutes.

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

ID de champ de canal, spécifiés sous la forme d'une paire nom-valeur composée de Fields et de valeurs numériques de l'ID de champ de canal à partir duquel récupérer les données.

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

Indicateur pour afficher les informations de position des données du canal, spécifiées sous la forme d'une paire nom-valeur composée de Location et d'une valeur logique. Les informations de localisation incluent la latitude, la longitude et l'altitude.

Exemple : thingSpeakRead(12397,Location=true);

Nombre de jours de données à partir desquels extraire les données, spécifié sous la forme d'une paire nom-valeur composée de 'NumDays' et d'une valeur numérique. Le nombre de jours est mesuré en périodes de 24 heures. Le serveur ThingSpeak limite le nombre de points restitués à un maximum de 8000. Ajustez votre nombre de jours ou effectuez plusieurs appels si vous avez besoin de plus de 8 000 points de données.

Remarque

Vous ne pouvez pas utiliser NumDays avec DateRange ou NumMinutes.

Exemple : thingSpeakRead(12397,NumDays=2);

Nombre de minutes de données à partir desquelles extraire les données, spécifié sous la forme d'une paire nom-valeur composée de 'NumMinutes' et d'une valeur numérique. Le nombre de minutes de données à récupérer est mesuré à partir du moment où la commande est émise. Le serveur ThingSpeak limite le nombre de points restitués à un maximum de 8000. Ajustez votre nombre de minutes ou effectuez plusieurs appels si vous avez besoin de plus de 8 000 points de données.

Remarque

Vous ne pouvez pas utiliser NumMinutes avec DateRange ou NumDays.

Exemple : thingSpeakRead(12397,NumMinutes=20);

Types de données : double

Nombre de points de données à extraire, spécifié sous la forme d'une paire nom-valeur composée de 'NumPoints' et d'une valeur numérique. Le nombre de points ou de lignes de données est compté à partir du moment où la commande est émise. Le serveur ThingSpeak limite le nombre de points restitués à un maximum de 8000.

Exemple : thingSpeakRead(12397,NumPoints=200);

Classe des données de sortie, spécifiée sous la forme d'une paire séparée par des virgules composée de 'OutputFormat' et d'une valeur de texte. Les valeurs valides sont 'matrix', 'table' et 'timetable'. Utilisez le format 'matrix' pour les données numériques. Vous pouvez utiliser 'timetable' ou 'table' pour toute donnée non numérique. Le format 'table' produit [data,channelInfo], où data contient les horodatages et les données des champs du canal. Le format 'timetable' produit [data,channelInfo], où data est une timetable et contient autant de variables que le nombre de demandé. .

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

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

clé d'API en lecture du canal , spécifiée sous la forme d'une paire nom-valeur composée de 'ReadKey' et d'un vecteur de caractères représentant une clé d'API en lecture du canal . La clé d'API en lecture vous permet de lire les données d'un canal privé. Vous pouvez trouver la clé d'API en lecture d'un canal dans l'onglet Clés API de votre vue des canaux ThingSpeak . Si vous lisez des données à partir d'un canal public, vous n'avez pas besoin d'une clé d'API en lecture. Enregistrez la clé d'API en lecture de votre canal dans une variable pour plus de commodité.

Exemple : thingSpeakRead(12397,ReadKey='F6CSCVKX42WFZN9Y');

Types de données : char

Délai d'expiration de la connexion au serveur, spécifié sous la forme d'une paire nom-valeur composée de 'Timeout' et d'une valeur numérique. La valeur est le nombre de secondes accordées à thingSpeakRead pour se connecter au serveur.

Exemple : thingSpeakRead(12397,Timeout=15);

Arguments de sortie

réduire tout

Données du canal, renvoyées sous la forme d'un tableau, d'une table ou timetable.

Horodatage de chaque élément de données, renvoyé sous la forme d'un tableau de valeurs datetime.

Types de données : datetime

Informations sur le canal, renvoyées sous forme de structure avec des champs dans l'ordre indiqué dans le tableau.

ChampDescription
ChannelID

Numéro d'identification du canal

Name

Nom du canal

Description

Description du canal

Latitude

Latitude du canal telle qu'indiquée dans les paramètres du canal

Longitude

Longitude du canal telle que fournie dans les paramètres du canal

Altitude

Altitude pour le canal comme indiqué dans les paramètres du canal

Created

Datetime de la date de création du canal

Updated

Date/heure à laquelle les paramètres des canaux ont été modifiés pour la dernière fois

Last EntryID

ID d'entrée pour la mise à jour de canal la plus récente

Field Descriptions

Liste des noms de champs

Field IDs

Liste des champs activés

URL

URL des données de flux

En savoir plus

réduire tout

Historique des versions

Introduit dans R2019a

Voir aussi

Fonctions