Считайте данные, хранимые в канале ThingSpeak
data = thingSpeakRead(channelID)
data = thingSpeakRead(channelID,Name,Value)NameЗначение парные аргументы. Чтобы считать нечисловые данные, необходимо задать ‘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 ограничивает число точек, возвращенное максимум в 8 000. Настройте свои области значений или выполните множественные вызовы, если вам нужны больше чем 8 000 точек данных.
Примечание
Вы не можете использовать DateRange с NumDays или NumMinutes.
Пример: thingSpeakRead(12397,'DateRange',[datetime('Aug 8, 2014'),datetime('Aug 12, 2014')]);
'Fields' — Поля каналаПоле IDs канала в виде разделенной запятой пары, состоящей из 'Fields' и числовые значения поля ID канала, чтобы получить данные от.
Пример: thingSpeakRead(12397,'Fields',[1,3,4]);
'Location' — Информация о местонахождении данныхИндикатор, чтобы отобразить информацию о местонахождении данных из канала в виде разделенной запятой пары, состоящей из 'Location' и логическое значение. Информация о местоположении включает широту, долготу и высоту.
Пример: thingSpeakRead(12397,'Location',true);
'NumDays' — Номер дней данныхНомер дней данных, чтобы извлечь данные из в виде разделенной запятой пары, состоящей из 'NumDays' и числовое значение. Номер дней измеряется в 24-часовые периоды. Сервер ThingSpeak ограничивает число точек, возвращенное максимум в 8 000. Настройте свой номер дней или выполните множественные вызовы, если вам нужны больше чем 8 000 точек данных.
Примечание
Вы не можете использовать NumDays с DateRange или NumMinutes.
Пример: thingSpeakRead(12397,'NumDays',2);
'NumMinutes' — Номер минут данныхНомер минут данных, чтобы извлечь данные из в виде разделенной запятой пары, состоящей из 'NumMinutes' и числовое значение. Номер минут данных, чтобы получить измеряется со времени, команда дается. Сервер ThingSpeak ограничивает число точек, возвращенное максимум в 8 000. Настройте свой номер минут или выполните множественные вызовы, если вам нужны больше чем 8 000 точек данных.
Примечание
Вы не можете использовать NumMinutes с DateRange или NumDays.
Пример: thingSpeakRead(12397,'NumMinutes',20);
Типы данных: double
'NumPoints' — Количество точек данныхКоличество точек данных, чтобы извлечь в виде разделенной запятой пары, состоящей из 'NumPoints' и числовое значение. Число точек или строки данных считаются со времени, команда дается. Сервер ThingSpeak ограничивает число точек, возвращенное максимум в 8 000.
Пример: thingSpeakRead(12397,'NumPoints',200);
'OutputFormat' — Класс выходных данныхКласс выходных данных в виде разделенной запятой пары, состоящей из 'OutputFormat' и текстовое значение. Допустимыми значениями является 'matrix'Таблица, и '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. Ключ API Чтения позволяет вам считывать данные из частного канала. Можно найти ключ API Чтения для канала на вкладке ключей API представления канала ThingSpeak. Если вы считываете данные из общедоступного канала, вам не нужен ключ API Чтения. Сохраните свой ключ 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 | Datetime даты создания канала |
Updated | Datetime, когда настройки каналов были в последний раз изменены |
Last EntryID | ID записи для нового обновления канала |
Field Descriptions | Список имен полей |
Field IDs | Список активированных полей |
URL | URL для данных о канале |
ThingSpeak является сервисом аналитической платформы IoT, который позволяет вам агрегировать, визуализировать и анализировать живые потоки данных в облаке. Смотрите Параметры лицензии и Коммерческое Использование для получения дополнительной информации.
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.