webread

从RESTful web服务读取内容

全页折叠

语法

数据= webread（URL）
data = webread (url、QueryName1 QueryValue1…, QueryNameN QueryValueN)
数据= webread (___选项)
(数据、colormapα)= webread (___)
(数据、Fs) = webread (___)

描述

例子

数据= webread（url)读取由指定的Web服务内容url并返回内容数据。

web服务提供了一个宁静的它返回格式化为internet媒体类型(如JSON、XML、图像或文本)的数据。

例子

数据= webread（url,QueryName1, QueryValue1,…, QueryNameN QueryValueN)将查询参数附加到url，由一个或多个名称-值参数对指定。若要将查询放入消息体，请使用webwrite。Web服务定义的查询参数。

例子

数据= webread（___,选项)添加其他HTTP请求选项，由指定的weboptions对象选项。您可以使用此语法与任何以前的语法的输入参数。

返回的数据为特定的输出类型，指定内容类型的属性选项。

若要使用函数读取内容，请指定ContentReader的属性选项作为函数的句柄。webread下载从Web服务数据和读取与指定函数的数据：

  • 如果指定一个函数的句柄，该函数返回多个输出参数，webread返回所有输出参数。

  • 如果为不返回输出参数的函数指定句柄(例如图像处理工具箱™函数)@implay视频文件)webread不返回输出参数。

(数据,colormap,α] = webread（___)从指定的web服务中读取图像url并返回图像数据。您可以使用以前的语法来只返回图像。使用此语法返回与图像相关联的颜色表和alpha通道。

webread当HTTP响应具有内容类型指定图像媒体类型和if的标题字段imread万博1manbetx支持图像格式。有关受支万博1manbetx持的图像格式，请参阅万博1manbetx支持的文件格式导入和导出。

(数据,Fs] = webread（___)从指定的web服务中读取音频数据url并返回音频数据数据。可以使用前面的语法只返回音频数据。使用此语法返回以赫兹为单位的音频数据的采样率。

webread返回音频数据时，HTTP响应有一个内容类型报头字段，用于指定一个音频媒体类型，并且如果audioread万博1manbetx支持音频格式。有关受支万博1manbetx持的音频格式，请参阅万博1manbetx支持的文件格式导入和导出。

例子

全部折叠

从哈勃遗产网站上阅读木星的图像并展示它。

URL ='http://heritage.stsci.edu/2007/14/images/p0714aa.jpg';RGB = webread（URL）;谁是rgb
类属性rgb 1000x800x3 2400000 uint8

调整大小和显示图像。

rgb = imresize (rgb, 0.6);imshow (rgb)

木星图像由NASA、ESA和哈勃遗产团队(STScI/AURA)提供。(见哈勃遗产信息中心参阅使用条款。)

读取温度数据为美国世界银行气候数据API。积的温度从年一九零一年至2012年。

从世界银行读取数据。这个API以JSON对象的形式返回数据。

api =“http://climatedataapi.worldbank.org/climateweb/rest/v1/”;URL = [API“国家/ cru /助教/年/美国];S = webread (url)
S = 112x1结构阵列字段：年数据

webread将JSON对象转换为结构数组。每个结构都包含年份和美国当年的平均温度，单位是摄氏度。

显示第一年的温度。

S（1）
ans =年份:1901数据:6.6187

画出平均温度。CONCATENATES.year和S.data放入数组并绘图。

年= [S.year];data = [S.data];情节(数据),包含(“年”);ylabel (的温度(摄氏度));标题（美国平均气温的）轴紧

世界银行提供的API和数据:气候数据API。(见世界银行:气候数据API有关API的更多信息，以及世界银行:使用条款。)

搜索过去7天内上传的包含单词的文件交换万博1manbetx®。

指定查询参数。webread追加Web服务的查询参数名称和值的URL。该文件交换网络服务定义术语和持续时间查询参数，而不是webread函数。

URL =“//www.tianjin-qmedu.com/matlabcentral/fileexchange/”;data = webread (url,“术语”,“万博1manbetx模型”,“持续时间”，7）;

webread以字符数组的形式返回搜索结果页面的HTML。

指定将数据从世界银行气候数据API读取到字符数组的附加请求选项。

创建一个weboptions对象并设置其内容类型来“文本”。该webread函数将JSON对象转换为字符数组而不是结构数组。显示字符数组的开头。

api =“http://climatedataapi.worldbank.org/climateweb/rest/v1/”;URL = [API“国家/ cru /助教/年/美国];选择= weboptions (“ContentType”,“文本”);data = webread (url选项);数据(1:62)
ans =[{“年”:1901年,“数据”:6.6187487},{“年”:1902年,“数据”:6.4643273}

世界银行提供的API和数据:气候数据API。(见世界银行:气候数据API有关API的更多信息，以及世界银行:使用条款。)

发送一个HTTP POST请求来搜索在过去七天内上传的包含单词的文件交换万博1manbetx。

URL =“//www.tianjin-qmedu.com/matlabcentral/fileexchange/”;选择= weboptions ('RequestMethod',“后”);data = webread (url,“术语”,“万博1manbetx模型”,“持续时间”，如图7所示，选项）;

许多web服务除了提供GET之外，还提供了用于请求数据的POST方法。

阅读来自美国国家航空航天局地球观测(NEO)网络地图服务的蓝色大理石:2004年12月的下一代图像。

用a指定请求的映像的日期datetime对象。指定格式的属性D使格式与web服务所需的格式相匹配。

URL =“http://neowms.sci.gsfc.nasa.gov/wms/wms”;01 D = datetime(2004年,12日,“格式”,'YYYY-MM-DD');rgb = webread (url,“时间”D…“服务”,“世界媒体峰会”,“层”,“BlueMarbleNG-TB”,“CRS”,'CRS：84',…“格式”,'图像/ JPEG','高度',256,'宽度',512,…“BBOX”,-180.0、-90.0,180.0,90.0的,“版本”,1.3.0“版本”,“请求”,“GetMap”);imshow (rgb)

webread转换datetime对象，以便它们可以是web服务查询参数的值。示例中的所有名称-值对都提供由NEO Web映射服务指定的查询参数。

蓝色大理石：下一代+地形和水深美国宇航局地球观测站的形象礼貌。访问图像和服务受到新的Web地图服务（WMS）提供。(见美国航空航天局地球观测组织信贷和使用条款。对于WMS查询参数，搜索NASA地球观测现场，WMS 1.3.0能力。)

输入参数

全部折叠

指向web服务的URL，指定为字符向量或字符串标量。web服务实现了一个RESTful接口。看到宁静的了解更多信息。

例：webread（ '//www.tianjin-qmedu.com/matlabcentral'）读取web页面并将其HTML作为字符数组返回。

Web服务查询参数，指定为一个或多个名称-值参数对。一个QueryName参数必须指定的查询参数的名称，作为一个特征向量或串标。一个QueryValue参数必须是字符向量、字符串标量或数字、逻辑或datetime值，指定查询参数的值。数字，逻辑和datetime值可以是数组。web服务定义作为请求的一部分接受的名称-值对。

当你指定QueryValue作为一个datetime对象，则必须指定其格式属性，使之与Web服务所要求的格式一致。如果格式属性包括时区或偏移量，以及datetime对象没有分区webread指定“本地”由于时区。

什么时候QueryValue在数组中包含多个值，您可能需要指定ArrayFormat财产的weboptions对象，以便按照web服务指定的方式对数组进行形式编码。

例：webread (“//www.tianjin-qmedu.com/matlabcentral/fileexchange/”,“词”,“webread”)检索上传至文件交换包含单词的文件列表webread。

附加的HTTP请求选项，指定为weboptions对象。

可以指定内容类型财产的weboptions对象，并将该对象作为输入参数传递给webread。然后webread返回数据就像这样的输出。表中列出了可以在a中指定的有效内容类型weboptions对象。

内容类型符

输出类型

“汽车”（默认）

根据服务器指定的内容类型自动确定输出类型。

“文本”

内容类型的字符向量:

纯文本/
text / html
text / xml
应用程序/ XML
应用程序/ javascript
应用程序/ x-javascript
应用程序/ x-WWW窗体-urlencoded

如果web服务返回MATLAB®文件。m延伸，该函数返回其作为特征向量的内容。

“图像”

用于的数字或逻辑矩阵图像/格式内容。如果第一个输出参数是索引图像，第二个输出参数是colormap，第三个输出参数是alpha通道。

有关受支万博1manbetx持的图像格式，请参阅万博1manbetx支持的文件格式导入和导出。

“音频”

数字矩阵音频/格式数字标量采样率作为第二个输出参数的内容。

有关受支万博1manbetx持的音频格式，请参阅万博1manbetx支持的文件格式导入和导出。

“二进制”

uint8用于二进制内容的列向量(即不作为类型处理的内容)烧焦)。

'表'

用于电子表格和CSV的标量表对象(文本/ csv)的内容。

json的

烧焦、数字、逻辑、结构或单元格数组应用程序/ JSON内容。

'XMLDOM'

Java®为文档对象模型（DOM）节点text / xml或应用程序/ XML内容。如果没有指定，则函数返回的XML内容作为特征向量。

'生的'

烧焦为列向量“文本”,'XMLDOM',json的内容。函数以a的形式返回任何其他内容类型uint8列向量。

看到weboptions对于所有的请求选项weboptions属性。

输出参数

全部折叠

从web服务读取的内容，以标量、数组、结构或表的形式返回。

与索引图像关联的Colormap，以数字数组的形式返回。

与索引图像相关联的alpha通道，返回为数字阵列。

音频数据的采样率(赫兹)，作为正的数字标量返回。

更多关于

全部折叠

宁静的

休息手段表述性状态转移，这是一种用于web服务的通用体系结构样式。RESTful接口提供了标准的HTTP方法，如GET、PUT、POST或DELETE。

提示

  • 对于未通过RESTful Web服务的功能支万博1manbetx持的功能，请参阅HTTP接口。

  • webread万博1manbetx支持HTTP GET和POST方法。许多web服务同时提供GET和POST方法来请求数据。要发送HTTP POST请求，请指定RequestMethod的属性选项作为“后”。然而,webread看跌期权查询选项进入url，而不是在请求消息的正文中。若要将查询放入正文，请使用webwrite。

  • 对于HTTP POST请求，则webread只有功能支持万博1manbetx应用程序/ x-WWW窗体-urlencoded媒体类型。若要发送包含任何其他internet媒体类型内容的POST请求，请使用webwrite。

  • 此函数不检查文档内容以确定如何处理它。例如，HTML和XML文档通常包含一个< meta >指定文档字符编码的标记。如果编码与默认编码不同webread编码，然后指定正确的CharacterEncoding选项weboptions。

另请参阅

||||||||

主题

外部网站

介绍了R2014b

MATLAB文档
万博1manbetx
用MATLAB引入深度学习

用MATLAB引入深度学习

下载电子书