thingSpeakRead

Считайте данные, хранимые в канале ThingSpeak

Описание

пример

data = thingSpeakRead(channelID) считывает новые данные из всех полей заданного общедоступного канала на ThingSpeak.com и возвращает данные как числовой тип.

пример

data = thingSpeakRead(channelID,Name,Value) дополнительные опции использования заданы одним или несколькими NameЗначение парные аргументы. Чтобы считать нечисловые данные, необходимо задать ‘OutputFormat’.

пример

data = thingSpeakRead(___,'ReadKey','channel Read API key') использует ключ API Чтения ThingSpeak™, чтобы читать из частного канала.

пример

[data,timestamps] = thingSpeakRead(___) также возвращает метки времени в заданный канал на ThingSpeak.com и может включать любой из входных параметров в предыдущих синтаксисах.

пример

[data,timestamps,channelInfo] = thingSpeakRead(___) также возвращает информацию о канале.

Примеры

свернуть все

Получите прошлые пять минут данных из полей 1 и 4 общедоступного канала и возвратите данные в расписании.

data = thingSpeakRead(12397,'Fields',[1,4],'NumPoints',3,'OutputFormat','TimeTable')
data =

  3×2 timetable

         Timestamps         WindDirectionNorth0Degrees    TemperatureF
    ____________________    __________________________    ____________

    14-May-2020 10:17:34               175                      64    
    14-May-2020 10:18:34               223                    64.3    
    14-May-2020 10:19:34               211                    64.1    

Считайте прошлые пять минут данных из полей 1 и 4 общедоступного канала и возвратите данные в таблице.

data = thingSpeakRead(12397,'Fields',[1,4],'NumMinutes',5,'OutputFormat','TimeTable')
data =

  11×2 timetable

         Timestamps         WindDirectionNorth0Degrees    TemperatureF
    ____________________    __________________________    ____________

    14-May-2020 10:08:34               216                    63.2    
    14-May-2020 10:09:34               183                    62.9    
    14-May-2020 10:10:34               139                      63    
    14-May-2020 10:11:34               179                    62.9    
    14-May-2020 10:12:34               225                    62.9    
    14-May-2020 10:13:34               250                      63    
    14-May-2020 10:14:34               177                    63.2    
    14-May-2020 10:15:34               196                    63.8    
    14-May-2020 10:16:34               196                    63.8    
    14-May-2020 10:17:34               175                      64    
    14-May-2020 10:18:34               223                    64.3    

Получите новый результат для всех полей общедоступного канала, включая метку времени.

[data,timestamps] = thingSpeakRead(12397)
data =

  199.0000    6.1000   18.0000   63.6000         0   30.0500    4.1390         0


timestamps = 

  datetime

   14-May-2020 10:20:34

Получите прошлые пять минут данных из полей 1 и 4 общедоступного канала, включая информацию о канале и метку времени.

[data,timestamps,channelInfo] = thingSpeakRead(12397,'Fields',[1,4],'NumMinutes',5)
data =

  316.0000   62.5000
  276.0000   62.9000
  124.0000   63.0000
  283.0000   63.6000
   94.0000   63.8000
  285.0000   64.1000
  233.0000   64.1000
  269.0000   64.0000
  255.0000   63.8000
  203.0000   64.0000
  237.0000   64.1000


timestamps = 

  11×1 datetime array

   14-May-2020 10:24:34
   14-May-2020 10:25:34
   14-May-2020 10:26:34
   14-May-2020 10:27:34
   14-May-2020 10:28:34
   14-May-2020 10:29:34
   14-May-2020 10:30:34
   14-May-2020 10:31:34
   14-May-2020 10:32:34
   14-May-2020 10:33:34
   14-May-2020 10:34:34


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:28:40
          LastEntryID: 2852997
    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?'

Получите данные с 11:59:01 9 августа 2018 в течение 12:02:52 10 августа 2018 для полей 1 и 4 общедоступного канала, включая информацию о канале и метку времени.

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

Входные параметры

свернуть все

Идентификационный номер канала в виде положительного целого числа. Для частных каналов необходимо также задать ‘ReadKey’аргумент.

Типы данных: double

Аргументы name-value

Задайте дополнительные разделенные запятой пары Name,Value аргументы. Name имя аргумента и Value соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: thingSpeakRead(12397,'Location',true);

Область значений данных, чтобы возвратиться в виде разделенной запятой пары, состоящей из 'DateRange' и массив значений, которые имеют [startdate,enddate] в MATLAB® datetime значения. Сервер ThingSpeak ограничивает число точек, возвращенное максимум в 8 000. Настройте свои области значений или выполните множественные вызовы, если вам нужны больше чем 8 000 точек данных.

Примечание

Вы не можете использовать DateRange с NumDays или NumMinutes.

Пример: thingSpeakRead(12397,'DateRange',[datetime('Aug 8, 2014'),datetime('Aug 12, 2014')]);

Поле IDs канала в виде разделенной запятой пары, состоящей из 'Fields' и числовые значения поля ID канала, чтобы получить данные от.

Пример: thingSpeakRead(12397,'Fields',[1,3,4]);

Индикатор, чтобы отобразить информацию о местонахождении данных из канала в виде разделенной запятой пары, состоящей из 'Location' и логическое значение. Информация о местоположении включает широту, долготу и высоту.

Пример: thingSpeakRead(12397,'Location',true);

Номер дней данных, чтобы извлечь данные из в виде разделенной запятой пары, состоящей из 'NumDays' и числовое значение. Номер дней измеряется в 24-часовые периоды. Сервер ThingSpeak ограничивает число точек, возвращенное максимум в 8 000. Настройте свой номер дней или выполните множественные вызовы, если вам нужны больше чем 8 000 точек данных.

Примечание

Вы не можете использовать NumDays с DateRange или NumMinutes.

Пример: thingSpeakRead(12397,'NumDays',2);

Номер минут данных, чтобы извлечь данные из в виде разделенной запятой пары, состоящей из 'NumMinutes' и числовое значение. Номер минут данных, чтобы получить измеряется со времени, команда дается. Сервер ThingSpeak ограничивает число точек, возвращенное максимум в 8 000. Настройте свой номер минут или выполните множественные вызовы, если вам нужны больше чем 8 000 точек данных.

Примечание

Вы не можете использовать NumMinutes с DateRange или NumDays.

Пример: thingSpeakRead(12397,'NumMinutes',20);

Типы данных: double

Количество точек данных, чтобы извлечь в виде разделенной запятой пары, состоящей из 'NumPoints' и числовое значение. Число точек или строки данных считаются со времени, команда дается. Сервер ThingSpeak ограничивает число точек, возвращенное максимум в 8 000.

Пример: thingSpeakRead(12397,'NumPoints',200);

Класс выходных данных в виде разделенной запятой пары, состоящей из 'OutputFormat' и текстовое значение. Допустимыми значениями является 'matrix'Таблица, и 'timetable'. Используйте 'matrix' формат для числовых данных. Можно использовать 'timetable' или 'table' для любых нечисловых данных. 'table' форматы вывода [data,channelInfo], где data содержит метки времени и данные из полей канала. 'timetable' форматы вывода [data,channelInfo], где data расписание и содержит столько же переменных сколько количество требуемого 'fields'.

Пример: thingSpeakRead(12397,'OutputFormat','table');

Пример: thingSpeakRead(12397,'OutputFormat','timetable');

Считайте ключ API канала в виде разделенной запятой пары, состоящей из 'ReadKey' и вектор символов, представляющий канал, считал ключ API. Ключ API Чтения позволяет вам считывать данные из частного канала. Можно найти ключ API Чтения для канала на вкладке ключей API представления канала ThingSpeak. Если вы считываете данные из общедоступного канала, вам не нужен ключ API Чтения. Сохраните свой ключ API Чтения канала в переменной для удобства.

Пример: thingSpeakRead(12397,'ReadKey','F6CSCVKX42WFZN9Y');

Типы данных: char

Период тайм-аута связи сервера в виде разделенной запятой пары, состоящей из 'Timeout' и числовое значение. Значение является номером допускавших секунд thingSpeakRead связывать с сервером.

Пример: thingSpeakRead(12397,'Timeout',15);

Выходные аргументы

свернуть все

Данные из канала, возвращенного как массив, таблица или расписание.

Метка времени каждого элемента данных, возвращенного как массив datetime значения.

Типы данных: datetime

Информация о канале, возвращенная как структура с полями в порядке, показанном в таблице..

Поле Описание
ChannelID

Идентификационный номер канала

Name

Имя канала

Description

Описание канала

Latitude

Широта для канала как предусмотрено в настройках канала

Longitude

Долгота для канала как предусмотрено в настройках канала

Altitude

Вертикальное изменение для канала как предусмотрено в настройках канала

Created

Datetime даты создания канала

Updated

Datetime, когда настройки каналов были в последний раз изменены

Last EntryID

ID записи для нового обновления канала

Field Descriptions

Список имен полей

Field IDs

Список активированных полей

URL

URL для данных о канале

Больше о

свернуть все

ThingSpeak

ThingSpeak является сервисом аналитической платформы IoT, который позволяет вам агрегировать, визуализировать и анализировать живые потоки данных в облаке. Смотрите Параметры лицензии и Коммерческое Использование для получения дополнительной информации.

Смотрите также

Функции

Введенный в R2019a