Считайте данные, хранимые в канале 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
____________________ __________________________ ____________
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,timestamps] = thingSpeakRead(12397)
Получите прошлые пять минут данных из полей 1 и 4 общедоступного канала, включая информацию о канале и метку времени.
[data,timestamps,channelInfo] = thingSpeakRead(12397,'Fields',[1,4],'NumMinutes',5)
Получите данные с 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)])
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. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.