Считайте данные, хранимые в канале ThingSpeak
считывает новые данные из всех полей заданного общедоступного канала на ThingSpeak.com и возвращает данные как числовой тип.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. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.