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

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.

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

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

[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.

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

Exemples

Récupérer trois points de données d'un canal dans un horaire

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

Récupérer cinq minutes de données d'un canal dans un horaire

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.

Récupérer des données récentes avec son horodatage

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

Récupérez cinq minutes de données avec des horodatages et des informations sur les canaux

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

Récupérer des données à partir d'une plage de dates spécifique

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

channelID — Numéro d'identification du canal

numérique

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

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);

DateRange — Plage de temps pour les données collectées

vecteur de date et d'heure

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')]);

Fields — Champs de canal

scalaire numérique positif

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]);

Location — Informations de position des données

logique

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);

NumDays — Nombre de jours de données

scalaire numérique positif

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);

NumMinutes — Nombre de minutes de données

scalaire numérique positif

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

NumPoints — Nombre de points de données

scalaire numérique positif

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);

OutputFormat — Classe des données de sortie

matrice (par défaut) | tableau | timetable

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');

ReadKey — Lire la clé d'API du canal

vecteur de caractères de la clé API | scalaire de chaîne de caractère de la clé API

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

Timeout — Délai d'expiration de la connexion au serveur

dix (par défaut) | scalaire numérique positif

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

data — Données du canal

déployer (par défaut) | tableau | timetable

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

timestamps — Horodatage de chaque élément de données

déployer (par défaut)

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

Types de données : datetime

channelInfo — Informations sur le canal

structure

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

Champ	Description
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

ThingSpeak

ThingSpeak est un service de plateforme d'analyse IoT qui vous permet d'agréger, de visualiser et d'analyser des flux de données temps réel dans le cloud. Voir License Options et Commercial Use pour plus d'informations.

Historique des versions

Introduit dans R2019a

Voir aussi

Fonctions

• thingSpeakWrite | webread (MATLAB)