Exponenta Banner

thingSpeakRead

Чтение данных, хранящихся в канале ThingSpeak

Свернуть все на странице

Синтаксис

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

Описание

пример

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

пример

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

пример

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

пример

[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 должны находиться внутри кавычек. Можно задать несколько аргументов в виде пар имен и значений в любом порядке Name1,Value1,...,NameN,ValueN.

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

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

Примечание

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

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

Идентификаторы полей каналов, заданные как разделенная разделенными запятой парами, состоящая из 'Fields' и числовые значения идентификатора поля канала для извлечения данных из.

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

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

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

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

Примечание

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

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

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

Примечание

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

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

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

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

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

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

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

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

Считайте API-ключ канала, заданный как разделенная разделенными запятой парами, состоящая из 'ReadKey' и вектор символов, представляющий ключ API считывания канала. Ключ Read API позволяет считывать данные с частного канала. Вы можете найти ключ Read API для канала на вкладке API Keys вашего представления канала ThingSpeak. Если вы считываете данные из общедоступного канала, вам не нужен ключ Read API. Сохраните свой канал Read 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

Идентификатор записи для последнего обновления канала

Field Descriptions

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

Field IDs

Список включенных полей

URL

URL-адрес для данных канала

Подробнее о

свернуть все

ThingSpeak

ThingSpeak - это сервис аналитической платформы Интернета вещей, позволяющий агрегировать, визуализировать и анализировать живые потоки данных в облаке. Дополнительные сведения см. в разделах «Опции лицензии» и «Коммерческое использование».

См. также

Функции

Введенный в R2019a

Документация MATLAB

Поддержка