thingSpeakWrite

Запись данных в канал ThingSpeak

Свернуть все на странице

Синтаксис

thingSpeakWrite(channelID,data,'WriteKey','channel write API key')
thingSpeakWrite(___,Name,Value)
response = thingSpeakWrite(___)

Описание

пример

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

пример

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

пример

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

Примеры

свернуть все

Открыть Live Script

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

thingSpeakWrite(17504,2.3,'WriteKey','23ZLGOBBU9TWHG2H')
Открыть Live Script

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

response = thingSpeakWrite(17504,[2.3,1.2,3.2,0.1],'WriteKey','23ZLGOBBU9TWHG2H')
Открыть Live Script

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

thingSpeakWrite(17504,{2.3,'on','good'},'WriteKey','23ZLGOBBU9TWHG2H')
Открыть Live Script

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

thingSpeakWrite(17504,'Fields',[1,4,6],'Values',{2.3,'on','good'},'WriteKey','23ZLGOBBU9TWHG2H')
Открыть Live Script

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

thingSpeakWrite(17504,[1.1,2.3,4],'Location',[-40,23,35],'WriteKey','23ZLGOBBU9TWHG2H')
Открыть скрипт

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

thingSpeakWrite(17504,'Location',[-40,23,3500],'WriteKey','23ZLGOBBU9TWHG2H')
Открыть Live Script

Запись временной метки для значения, записываемого в канал. Предоставленная временная метка интерпретируется как местное время.

tStamp = datetime('now')
thingSpeakWrite(17504,[2.3,1.2,3.2,0.1],'WriteKey','23ZLGOBBU9TWHG2H','TimeStamp',tStamp)
Открыть Live Script

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

% 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)
Открыть Live Script

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

% 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). Для вектора или 1-D массива ячеек данные записываются в последовательные поля, начиная с поля 1.

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

Напишите API-ключ канала, заданный как разделенная разделенными запятой парами, состоящая из 'WriteKey' и вектор символов, представляющий ключ API записи канала. Ключ Write API необходим для записи данных в канал. Вы можете найти ключ Write API для канала на вкладке API Keys вашего представления канала ThingSpeak. Сохраните свой канал Write 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');

Идентификаторы полей канала, заданные как разделенная разделенными запятой парами, состоящая из '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

Идентификатор записи для последнего обновления канала

Created

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

Updated

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

Last EntryID

Идентификатор записи для последнего обновления канала

Altitude

Повышение для операции записи

Ограничения

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

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

Подробнее о

свернуть все

ThingSpeak

ThingSpeak - это сервис аналитической платформы Интернета вещей, позволяющий агрегировать, визуализировать и анализировать живые потоки данных в облаке. Дополнительные сведения см. в разделах «Опции лицензии» и «Коммерческое использование».

См. также

Функции

Введенный в R2019a

Документация MATLAB

Поддержка

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