thingSpeakWrite

Запишите данные к каналу ThingSpeak

Описание

пример

thingSpeakWrite(channelID,data,'WriteKey','channel write API key') пишут данные в заданный канал. Ключ API Записи задан как разделенная запятой пара, состоящая из 'WriteKey' и вектор символов или строка, представляющая ключ записи канала.

пример

thingSpeakWrite(___,Name,Value) дополнительные опции использования заданы одним или несколькими Name,Value парные аргументы.

пример

response = thingSpeakWrite(___) возвращает ответ, обеспеченный сервером ThingSpeak™ на успешном завершении операции записи.

Примеры

свернуть все

Запишите одно числовое значение в Поле 1 канала.

thingSpeakWrite(17504,2.3,'WriteKey','23ZLGOBBU9TWHG2H')

Запишите числовые значения в первые четыре последовательных поля [1,2,3,4] из канала.

response = thingSpeakWrite(17504,[2.3,1.2,3.2,0.1],'WriteKey','23ZLGOBBU9TWHG2H')

Запишите нечисловые данные в первые три последовательных поля [1,2,3] из канала.

thingSpeakWrite(17504,{2.3,'on','good'},'WriteKey','23ZLGOBBU9TWHG2H')

Запишите смешанные значения в непоследовательные поля [1,4,6] из канала.

thingSpeakWrite(17504,'Fields',[1,4,6],'Values',{2.3,'on','good'},'WriteKey','23ZLGOBBU9TWHG2H')

Обновите три поля, и широту записи, долготу и высотные данные для записи.

thingSpeakWrite(17504,[1.1,2.3,4],'Location',[-40,23,35],'WriteKey','23ZLGOBBU9TWHG2H')

Запишите широту, долготу и высотные данные к каналу, не добавляя значения в поля.

thingSpeakWrite(17504,'Location',[-40,23,3500],'WriteKey','23ZLGOBBU9TWHG2H')

Запишите метку времени для значения, записанного в канал. Обеспеченная метка времени интерпретирована как местное время.

tStamp = datetime('now')
thingSpeakWrite(17504,[2.3,1.2,3.2,0.1],'WriteKey','23ZLGOBBU9TWHG2H','TimeStamp',tStamp)

Запишите матрицу данных к первым трем полям канала. Обеспеченные метки времени интерпретированы как местное время.

% Generate Random Data
data = randi(10,10,3);

% Generate timestamps for the data
tStamps = datetime('now')-minutes(9):minutes(1):datetime('now');

channelID = 17504; % Change to your Channel ID
writeKey = '23ZLGOBBU9TWHG2H'; % Change to your Write API Key

% Write 10 values to each field of your channel along with timestamps
thingSpeakWrite(channelID,data,'TimeStamp',tStamps,'WriteKey',writeKey)

Запишите расписание данных к первым двум полям канала. Обеспеченные метки времени интерпретированы как местное время.

% Generate random data
dataField1 = randi(10,10,1);
dataField2 = randi(10,10,1);

% Generate timestamps for the data
tStamps = [datetime('now')-minutes(9):minutes(1):datetime('now')]';

% Create timetable
dataTable = timetable(tStamps,dataField1,dataField2);
channelID = 17504; % Change to your channel ID
writeKey  = '23ZLGOBBU9TWHG2H'; % Change to your Write API Key

% Write 10 values to each field of your channel along with timestamps
thingSpeakWrite(channelID,dataTable,'WriteKey',writeKey)

Входные параметры

свернуть все

Идентификационный номер канала в виде положительного целого числа.

Данные, чтобы записать, чтобы образовать канал в виде числового скаляра или числового вектора, массива ячеек, строки массивов ячеек, таблицы или расписания. Если вы задаете скалярные данные, значение записано в первое поле в канале (Поле 1). Для вектора или 1D массива ячеек, данные записаны в последовательные поля начиная с Поля 1.

Пример: thingSpeakWrite(17504,{2,3,'on','good'},'WriteKey','channel write api key');

Запишите ключ API канала в виде разделенной запятой пары, состоящей из 'WriteKey' и вектор символов, представляющий канал, пишет ключ API. Ключ API Записи требуется, чтобы записывать данные в канал. Можно найти ключ API Записи для канала на вкладке ключей API представления канала ThingSpeak. Сохраните свой ключ API Записи канала в переменной для удобства.

Пример: thingSpeakRead(12397,'WriteKey','XXXXXXXXXXXXXXXX');

Аргументы в виде пар имя-значение

Задайте дополнительные разделенные запятой пары Name,Value аргументы. Name имя аргумента и Value соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: thingSpeakWrite(17504,[1.1,2.2],'Fields',[1,2,3],'WriteKey','channel write api key');

Поля IDs канала в виде разделенной запятой пары, состоящей из 'Fields' и положительное целочисленное значение 1 на n.

Пример: thingSpeakWrite(17504,[2.3,1.2,3.2,0.1],'Fields',[1,2,3,4],'WriteKey','channel write api key');

Значения данных в виде разделенной запятой пары, состоящей из 'Values' и числовой скаляр, числовой вектор, массив ячеек, строка массивов ячеек, таблицы или значений расписания. Задайте данные, которые будут записаны, чтобы образовать канал поля, заданные 'Fields' параметр.

Пример: thingSpeakWrite(17504,'Fields',[1,3,4],'Values',[1,2,3],'WriteKey','channel write api key');

Информация о местонахождении данных в канале в виде разделенной запятой пары, состоящей из 'Location' и числовой массив. Информация о местоположении включает широту, долготу и высоту. Этот пример пишет ту же информацию о местоположении для каждой из трех точек, предоставленных полю 1.

Пример: thingSpeakWrite(17504,[2.3,1.2,3.2,0.1],'Location',[-40,23,200],'WriteKey',' write api key');

Период тайм-аута связи сервера в виде разделенной запятой пары, состоящей из 'TimeOut' и числовое значение. Период тайм-аута является номером допускавших секунд thingSpeakRead чтобы связать с сервером перед, запрос отключен.

Пример: thingSpeakWrite(17504,[2.3,1.2,3.2,0.1],'WriteKey','write API key','Timeout',15);

Метка времени значений данных, записанных в поля в записи, образовывает канал в виде разделенной запятой пары, состоящей из 'Timestamp' и значение. Значением должен быть MATLAB® datetime значение. Все метки времени должны быть уникальными. Если вы представляете дублирующиеся метки времени, все ваши обновления отклоняются, в противном случае только обновления с метками времени уже в канале отклоняются.

Примечание

Не задавайте 'Timestamp' если вы задали 'Values' как расписание.

Пример: thingSpeakWrite(17504,[2.3,1.2,3.2,0.1],'WriteKey','channel write api key','Timestamp',[datetime('2/6/2018 9:27:12','format','MM/dd/uuuu HH:mm:ss')]);

Типы данных: datetime

Выходные аргументы

свернуть все

Ответ канала операции записи, возвращенной как структура с полями в порядке, показанном в таблице. Поля структуры указывают на значения, записанные в поля канала:

Поле Описание
FieldX

Данные FieldX для записи, до восьми полей

Latitude

Широта для операции записи

Longitude

Долгота для операции записи

Channel ID

Идентификационный номер канала

Created

Datetime операции записи и записи канала

Last EntryID

ID записи для нового обновления канала

Created

Datetime даты создания канала

Updated

Datetime, когда настройки каналов были в последний раз изменены

Last EntryID

ID записи для нового обновления канала

Altitude

Вертикальное изменение для операции записи

Ограничения

  • Все метки времени должны быть уникальными. Вы не можете записать новые данные с метками времени, которые совпадают с существующими данными в канале.

  • Позволенная частота обновления для канала ограничивается на основе вашего типа лицензии. Смотрите Часто Задаваемые Вопросы и Как Купить для определенной информации. Обновления с многократными въездами, такой как в таблице или расписании, ограничиваются более медленной частотой обновления. Для пользователей бесплатных учетных записей, количества сообщений в одном вызове thingSpeakWrite ограничивается 960 сообщениями. Для пользователей заплаченных учетных записей предел является 14 400 сообщениями. Попытки опубликовать на уровне быстрее, чем позволенный предел возвратят следующую ошибку: Запросы являются слишком частыми. Для получения дополнительной информации смотрите Ограничения в документации.

Больше о

свернуть все

ThingSpeak

ThingSpeak является сервисом аналитической платформы IoT, который позволяет вам агрегировать, визуализировать и анализировать живые потоки данных в облаке. Смотрите Параметры лицензии и Коммерческое Использование для получения дополнительной информации.

Смотрите также

Функции

Введенный в R2019a
Для просмотра документации необходимо авторизоваться на сайте