Считайте содержимое из веб-сервиса RESTful
data = webread(url)url и возвращает содержимое в data.
Веб-сервис обеспечивает УСПОКОИТЕЛЬНОЕ, которое возвращает данные, отформатированные как интернет-тип носителя, такой как JSON, XML, изображение или текст.
data = webread(url,QueryName1,QueryValue1,...,QueryNameN,QueryValueN)url, как задано одной или несколькими парами аргументов значения имени. Чтобы поместить запрос в тело сообщения, используйте webwrite. Веб-сервис задает параметры запроса.
data = webread(___,options)weboptions объект options. Можно использовать этот синтаксис с любым из входных параметров предыдущих синтаксисов.
Чтобы возвратить данные как определенный выходной тип, задайте ContentType свойство options.
Чтобы считать содержимое с функцией, задайте ContentReader свойство options как указатель на функцию. webread данные о загрузках из веб-сервиса и считывают данные с заданной функцией:
Если вы задаете указатель на функцию, которая возвращает несколько выходных аргументов, webread возвращает все выходные аргументы.
Если вы задаете указатель на функцию, которая не возвращает выходного аргумента (такого как функция Image Processing Toolbox™ @implay для видеофайлов), webread не возвращает выходного аргумента.
[ читает изображение из веб-сервиса, заданного data,colormap,alpha]
= webread(___)url и возвращает изображение в data. Можно использовать предыдущие синтаксисы, чтобы возвратить изображение только. Используйте этот синтаксис, чтобы возвратить палитру и альфа-каналы, сопоставленные с изображением.
webread возвращает изображение, когда ответ HTTP имеет Content-Type поле заголовка, которое задает тип носителя изображений и если imread поддерживает формат изображения. Для поддерживаемых форматов изображения смотрите Поддерживаемые Форматы файлов для Импорта и экспорта.
[ аудиоданные чтений из веб-сервиса заданы data,Fs]
= webread(___)url и возвращает аудиоданные в data. Можно использовать предыдущие синтаксисы, чтобы возвратить аудиоданные только. Используйте этот синтаксис, чтобы возвратить частоту дискретизации аудиоданных в герц.
webread возвращает аудиоданные, когда ответ HTTP имеет Content-Type поле заголовка, которое задает аудио тип носителя и если audioread поддерживает формат аудио. Для поддерживаемых форматов аудио смотрите Поддерживаемые Форматы файлов для Импорта и экспорта.
Считайте изображение Юпитера от веб-сайта Наследия Хаббла и отобразите его.
url = 'http://heritage.stsci.edu/2007/14/images/p0714aa.jpg'; rgb = webread(url); whos rgb
Name Size Bytes Class Attributes rgb 1000x800x3 2400000 uint8
Измените размер и отобразите изображение.
rgb = imresize(rgb,0.6); imshow(rgb)
Любезность Юпитера изображений НАСА, ЕКА и Команды Наследия Хаббла (STScI/AURA). (См. Информационный центр Наследия Хаббла для условий использования.)
Считайте температурные данные для США из Climate Data API World Bank. Постройте температуры с лет 1901–2012.
Считайте данные из World Bank. Этот API возвращает данные как объект JSON.
api = 'http://climatedataapi.worldbank.org/climateweb/rest/v1/'; url = [api 'country/cru/tas/year/USA']; S = webread(url)
S =
112x1 struct array with fields:
year
data
webread преобразует объект JSON в массив структур. Каждая структура содержит год и среднюю температуру в США в течение того года, в градусах Цельсия.
Отобразите температуру в течение первого года.
S(1)
ans =
year: 1901
data: 6.6187
Постройте средние температуры. Конкатенация S.year и S.data в массивы и строят их.
year = [S.year]; data = [S.data]; plot(year,data) xlabel('Year'); ylabel('Temperature (Celsius)'); title('USA Average Temperatures') axis tight
API и любезность данных World Bank: Climate Data API. (См. World Bank: Climate Data API для получения дополнительной информации о API и World Bank: Условия использования.
Ищите Обмен файлами файлы, загруженные в течение прошлых семи дней, которые содержат слово Simulink®.
Задайте параметры запроса. webread добавляет имена параметра запроса веб-сервиса и значения к URL. Веб-сервис File Exchange задает term и duration параметры запроса, не webread функция.
url = 'https://www.mathworks.com/matlabcentral/fileexchange/'; data = webread(url,'term','simulink','duration',7);
webread возвращает HTML для страницы результата поиска как символьный массив.
Задайте дополнительную опцию запроса, чтобы считать данные от Climate Data API World Bank до символьного массива.
Создайте weboptions объект и набор его ContentType к 'text'. webread функция преобразует объект JSON в символьный массив вместо массива структур. Отобразите начало символьного массива.
api = 'http://climatedataapi.worldbank.org/climateweb/rest/v1/'; url = [api 'country/cru/tas/year/USA']; options = weboptions('ContentType','text'); data = webread(url,options); data(1:62)
ans =
[{"year":1901,"data":6.6187487},{"year":1902,"data":6.4643273}API и любезность данных World Bank: Climate Data API. (См. World Bank: Climate Data API для получения дополнительной информации о API и World Bank: Условия использования.
Считайте Синий Мрамор: изображение Следующего поколения на декабрь 2004 от Наблюдения Земли НАСА (NEO) сервис веб-карт.
Задайте дату требуемого изображения с datetime объект. Задайте Format свойство D так, чтобы формат совпадал с форматом, требуемым веб-сервисом.
url = 'http://neowms.sci.gsfc.nasa.gov/wms/wms'; D = datetime(2004,12,01,'Format','yyyy-MM-dd'); rgb = webread(url,'Time',D, ... 'Service','WMS','Layers','BlueMarbleNG-TB','CRS','CRS:84', ... 'Format','image/jpeg','Height',256,'Width',512, ... 'BBOX','-180.0,-90.0,180.0,90.0','Version','1.3.0','Request','GetMap'); imshow(rgb)
webread преобразует datetime объекты так, чтобы они могли быть значениями параметров запроса веб-сервиса. Все пары "имя-значение" в примере обеспечивают параметры запроса, заданные сервисом веб-карт NEO.
Синий Мрамор: Следующее поколение + Топография и Батиметрия отображает любезность Наземной Обсерватории НАСА. Доступ к формированию изображений и услугам, предоставленным сервисом веб-карт (WMS) NEO. (См. наблюдения Земли НАСА для кредита и условий использования. Для параметров запроса WMS ищите сайт наблюдений Земли НАСА, WMS 1.3.0 Возможности.)
Для функциональности, не поддержанной функциями веб-сервисов RESTful, смотрите Интерфейс HTTP.
webread методы HTTP GET и POST поддержек. Много веб-сервисов обеспечивают и GET и методы POST, чтобы запросить данные. Чтобы отправить запрос POST HTTP, задайте RequestMethod свойство options как 'post'. Однако webread помещает опции запроса в url, не в теле сообщения запроса. Чтобы поместить запрос в тело, используйте webwrite.
Для запросов POST HTTP, webread функционируйте поддерживает только application/x-www-form-urlencoded 'MediaType' . Чтобы отправить запрос POST с содержимым любого другого интернет-типа носителя, используйте webwrite.
Эта функция не исследует содержимое документа, чтобы определить, как обработать ее. Например, HTML и XML-документы часто содержат <meta> пометьте, который задает кодировку символов документа. Если кодирование отличается от webread по умолчанию кодирование, затем задайте правильный CharacterEncoding опция в weboptions.
audioread | datetime | imread | jsondecode | readtable | weboptions | websave | webwrite | xmlread