Считывание данных, хранящихся в канале ThingSpeak
data = thingSpeakRead(channelID)
data = thingSpeakRead(channelID,Name,Value)Name,Value аргументы пары. Для чтения нечисловых данных необходимо указать "OutputFormat’.
[ также возвращает временные метки из указанного канала на ThingSpeak.com и может включать любой из входных аргументов в предыдущих синтаксисах.data,timestamps] = thingSpeakRead(___)
[ также возвращает информацию о канале.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?'channelID - Идентификационный номер каналаИдентификационный номер канала, указанный как положительное целое число. Для частных каналов необходимо также указать "ReadKey"аргумент.
Типы данных: double
Укажите дополнительные пары, разделенные запятыми Name,Value аргументы. Name является именем аргумента и Value - соответствующее значение. Name должен отображаться внутри кавычек. Можно указать несколько аргументов пары имен и значений в любом порядке как Name1,Value1,...,NameN,ValueN.
thingSpeakRead(12397,'Location',true);'DateRange' - Диапазон возвращаемых данныхДиапазон возвращаемых данных, указанный как разделенная запятыми пара, состоящая из 'DateRange' и массив значений, имеющих [startdate,enddate] в MATLAB
®datetime значения. Сервер ThingSpeak ограничивает количество возвращаемых точек максимум 8000. Настройте диапазоны или выполните несколько вызовов, если требуется более 8000 точек данных.
Примечание
Вы не можете использовать DateRange с NumDays или NumMinutes.
Пример: thingSpeakRead(12397,'DateRange',[datetime('Aug 8, 2014'),datetime('Aug 12, 2014')]);
'Fields' - Поля каналаИдентификаторы полей канала, определенные как пара, разделенная запятыми, состоящая из 'Fields' и числовые значения идентификатора поля канала для извлечения данных из.
Пример: thingSpeakRead(12397,'Fields',[1,3,4]);
'Location' - Позиционная информация данныхИндикатор для отображения позиционной информации данных из канала, заданной как разделенная запятыми пара, состоящая из 'Location' и логическое значение. Информация о местоположении включает широту, долготу и высоту.
Пример: thingSpeakRead(12397,'Location',true);
'NumDays' - Количество дней данныхКоличество дней извлечения данных, указанных как разделенная запятыми пара, состоящая из 'NumDays' и числовое значение. Количество дней измеряется в 24-часовые периоды. Сервер ThingSpeak ограничивает количество возвращаемых точек максимум 8000. Измените количество дней или выполните несколько вызовов, если требуется более 8000 точек данных.
Примечание
Вы не можете использовать NumDays с DateRange или NumMinutes.
Пример: thingSpeakRead(12397,'NumDays',2);
'NumMinutes' - Количество минут данныхКоличество минут извлечения данных, указанное как разделенная запятыми пара, состоящая из 'NumMinutes' и числовое значение. Количество минут извлечения данных измеряется с момента выдачи команды. Сервер ThingSpeak ограничивает количество возвращаемых точек максимум 8000. Измените количество минут или выполните несколько вызовов, если требуется более 8000 точек данных.
Примечание
Вы не можете использовать NumMinutes с DateRange или NumDays.
Пример: thingSpeakRead(12397,'NumMinutes',20);
Типы данных: double
'NumPoints' - Количество точек данныхКоличество извлекаемых точек данных, указанных как разделенная запятыми пара, состоящая из 'NumPoints' и числовое значение. Количество точек или строк данных отсчитывается с момента ввода команды. Сервер ThingSpeak ограничивает количество возвращаемых точек максимум 8000.
Пример: thingSpeakRead(12397,'NumPoints',200);
'OutputFormat' - Класс выходных данныхКласс выходных данных, указанный как разделенная запятыми пара, состоящая из 'OutputFormat' и текстовое значение. Допустимые значения: 'matrix', 'table', и 'timetable'. Использовать 'matrix' формат для числовых данных. Вы можете использовать 'timetable' или 'table' для любых нечисловых данных. 'table' выходные данные формата [data,channelInfo], где data содержит метки времени и данные из полей канала. 'timetable' выходные данные формата [data,channelInfo], где data является расписанием и содержит столько переменных, сколько запрошено 'fields'.
Пример: thingSpeakRead(12397,'OutputFormat','table');
Пример: thingSpeakRead(12397,'OutputFormat','timetable');
'ReadKey' - Считывание ключа API каналаСчитывание ключа API канала, заданного как пара, разделенная запятыми, состоящая из 'ReadKey' и вектор символов, представляющий ключ API считывания канала. Клавиша Read API позволяет считывать данные из частного канала. Ключ Read API для канала можно найти на вкладке API Keys представления канала ThingSpeak. При чтении данных из общедоступного канала ключ API Read не требуется. Для удобства сохраните ключ API чтения канала в переменной.
Пример: thingSpeakRead(12397,'ReadKey','F6CSCVKX42WFZN9Y');
Типы данных: char
'Timeout' - Время ожидания подключения к серверуВремя ожидания соединения с сервером, указанное как пара, разделенная запятыми, состоящая из 'Timeout' и числовое значение. Значение - это количество секунд, разрешенное для thingSpeakRead для подключения к серверу.
Пример: thingSpeakRead(12397,'Timeout',15);
data - Данные из каналаДанные из канала, возвращаемые в виде массива, таблицы или расписания.
timestamps - Временная метка каждого элемента данныхВременная метка каждого элемента данных, возвращаемая в виде массива datetime значения.
Типы данных: datetime
channelInfo - Информация о каналеИнформация о канале, возвращаемая в виде структуры с полями в порядке, указанном в таблице..
| Область | Описание |
|---|---|
ChannelID | Идентификационный номер канала |
Name | Название канала |
Description | Описание канала |
Latitude | Широта канала в соответствии с настройками канала |
Longitude | Долгота канала в соответствии с настройками канала |
Altitude | Отметка канала в соответствии с настройками канала |
Created | Дата и время создания канала |
Updated | Дата и время последнего изменения параметров каналов |
Last EntryID | Идентификатор записи для последнего обновления канала |
Field Descriptions | Список имен полей |
Field IDs | Список включенных полей |
URL | URL-адрес для данных канала |
ThingSpeak - это сервис платформы аналитики Интернета вещей, который позволяет агрегировать, визуализировать и анализировать потоки оперативных данных в облаке. Дополнительные сведения см. в разделе Параметры лицензии и коммерческое использование.
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.