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') использует ключ 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
    ____________________    __________________________    ____________

    15-Jan-2019 08:16:15               129                    26.1    
    15-Jan-2019 08:17:16               115                    26.1    
    15-Jan-2019 08:18:19               133                    26.2
Открыть скрипт

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

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

data =

  5×2 timetable

         Timestamps         WindDirectionNorth0Degrees    TemperatureF
    ____________________    __________________________    ____________

    13-Nov-2018 09:22:48               117                    53.4    
    13-Nov-2018 09:23:48               110                    53.4    
    13-Nov-2018 09:24:50                90                    53.5    
    13-Nov-2018 09:25:52                95                    53.5    
    13-Nov-2018 09:26:55                90                    53.5
Открыть скрипт

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

[data,timestamps] = thingSpeakRead(12397)

data =

  Columns 1 through 7

  175.0000    7.5000   45.0000   47.5000         0   29.6000    3.4000

  Column 8

   39.0000


timestamps = 

  datetime

   03-Jan-2019 14:30:36
Открыть скрипт

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

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

data =

  315.0000   39.7000
  314.0000   39.7000
  314.0000   39.8000
  314.0000   39.9000
  315.0000   39.9000


timestamps = 

  5×1 datetime array

   20-Nov-2018 08:29:39
   20-Nov-2018 08:30:40
   20-Nov-2018 08:31:41
   20-Nov-2018 08:32:41
   20-Nov-2018 08:33:43


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: 25-Sep-2018 20:08:42
          LastEntryID: 2132316
    FieldDescriptions: {1×8 cell}
             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: 25-Sep-2018 20:08:42
          LastEntryID: 2122785
    FieldDescriptions: {1×8 cell}
             FieldIDs: [1 2 3 4 5 6 7 8]
                  URL: 'https://api.thingspeak.com/channels/12397/feed.json?'

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

свернуть все

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

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

Аргументы в виде пар имя-значение

Укажите необязательные аргументы в виде пар ""имя, значение"", разделенных запятыми. Имя (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', 'table' и 'timetable'. Используйте формат 'matrix' для числовых данных. Можно использовать 'timetable' или 'table' для любых нечисловых данных. [data,channelInfo] форматов вывода 'table', где data содержит метки времени и данные из полей канала. [data,channelInfo] форматов вывода 'timetable', где data является расписанием и содержит столько же переменных сколько количество требуемого 'fields'.

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

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

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

Документация MATLAB
Поддержка