Считайте данные, хранимые в канале ThingSpeak
data = thingSpeakRead(channelID)
data = thingSpeakRead(channelID,Name,Value)
data = thingSpeakRead(___,'ReadKey','channel Read API key')
[data,timestamps]
= thingSpeakRead(___)
[data,timestamps,channelInfo]
= thingSpeakRead(___)
считывает новые данные из всех полей заданного общедоступного канала на ThingSpeak.com и возвращает данные как числовой тип.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 ____________________ __________________________ ____________ 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?'
channelID
— Идентификационный номер каналаИдентификационный номер канала, заданный как положительное целое число. Для частных каналов необходимо также задать аргумент 'ReadKey
'.
Типы данных: double
Укажите необязательные аргументы в виде пар ""имя, значение"", разделенных запятыми.
Имя (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'
— ChannelПоле IDs канала, заданное как пара, разделенная запятой, состоящая из 'Fields'
и числовые значения поля ID канала, чтобы получить данные от.
Пример: thingSpeakRead(12397,'Fields',[1,3,4]);
местоположение
Информация о местонахождении данныхИндикатор, чтобы отобразить информацию о местонахождении данных из канала, заданного как пара, разделенная запятой, состоящая из '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'
, 'table'
и 'timetable'
. Используйте формат 'matrix'
для числовых данных. Можно использовать 'timetable'
или 'table'
для любых нечисловых данных. [data,channelInfo]
форматов вывода 'table'
, где data
содержит метки времени и данные из полей канала. [data,channelInfo]
форматов вывода 'timetable'
, где data
является расписанием и содержит столько же переменных сколько количество требуемого 'fields'
.
Пример: thingSpeakRead(12397,'OutputFormat','table');
Пример: thingSpeakRead(12397,'OutputFormat','timetable');
'ReadKey'
— Считайте ключ API каналаСчитайте ключ API канала, заданного как пара, разделенная запятой, состоящая из 'ReadKey'
и вектора символов, представляющего ключ API чтения канала. Ключ API Чтения позволяет вам считывать данные из частного канала. Если вы считываете данные из общедоступного канала, вам не нужен ключ API Чтения. Сохраните свой ключ API Чтения канала в переменной для удобства.
Пример: thingSpeakRead(12397,'ReadKey','F6CSCVKX42WFZN9Y');
Типы данных: char
Тайм-аут
Период тайм-аута связи сервераПериод тайм-аута связи сервера, заданный как пара, разделенная запятой, состоящая из 'Timeout'
и числового значения. Значение является номером секунд, позволил, чтобы thingSpeakRead
соединился с сервером.
Пример: thingSpeakRead(12397,'Timeout',15);
данные
Данные из каналаДанные из канала, возвращенного как массив, таблица или расписание.
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. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.