韦布雷德

从RESTful web服务读取内容

描述

例子

数据= Webrad(URL.)从指定的Web服务中读取内容URL.并返回内容数据

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

例子

数据= Webrad(URL.,queryname1,queryvalue1,...,querynamen,queryvaluen)添加查询参数URL.,由一个或多个名称-值参数对指定。要将查询放入消息体中,请使用WebWrite.。Web服务定义查询参数。

例子

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

要将数据作为特定输出类型返回,请指定内容类型的属性选项

要使用函数读取内容,请指定ContentReader.的属性选项作为函数的句柄。韦布雷德从Web服务下载数据,并使用指定的功能读取数据:

  • 如果你指定一个返回多个输出参数的函数句柄,韦布雷德返回所有输出参数。

  • 如果将句柄指定为返回不返回输出参数的函数(例如图像处理工具箱™功能@implay对于视频文件),韦布雷德返回无输出参数。

(数据,COLOROMAP.,α] = Webradred(___)从指定的web服务读取图像URL.并返回图像数据。您可以使用以前的语法仅返回映像。使用此语法返回与图像关联的ColorMap和Alpha通道。

韦布雷德当HTTP响应有内容类型标题字段,指定图像媒体类型,如果Imread.金宝app支持图像格式。有关支持金宝app的图像格式,请参见金宝app支持的导入和导出的文件格式

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

韦布雷德HTTP响应有一个有关的音频数据内容类型指定音频媒体类型的标题字段,如果audioread金宝app支持音频格式。有关支持金宝app的音频格式,请参见金宝app支持的导入和导出的文件格式

例子

全部收缩

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

URL =.“https://hubblesite.org/uploads/image_file/image_attachment/14836/compass_large_web.jpg”;RGB = Webrabread(URL);谁是rgb
名称大小字节类属性RGB 500x500x3 750000 UINT8

调整大小并显示图像。

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

木星图像由美国宇航局,esa和哈勃遗产队(Stsci / Aura)提供。有关使用条款,请参阅太空望远镜科学研究所

从世界银行气候数据API读取美国的温度数据。从1901 - 2012年的剧情温度。

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

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

韦布雷德将JSON对象转换为结构数组。每个结构都包含当年美国的年份和平均温度,以摄氏度为单位。

显示第一年的温度。

S(1)
ans = year: 1901数据:6.6187

绘制平均气温。衔接S.yearS.data放入数组并绘制它们。

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

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

搜索文件兑换文件在包含单词的七天内上传的文件金宝app®

指定查询参数。韦布雷德将Web Service查询参数名称和值附加到URL。文件Exchange Web服务定义了术语持续时间查询参数,不是韦布雷德函数。

URL =.“//www.tatmou.com/matlabcentral/fileexchange/”;data = webrabread(URL,“术语”,'金宝appsimulink','期间',7);

韦布雷德将搜索结果页面的HTML返回为字符数组。

指定一个额外的请求选项,从世界银行气候数据API读取数据到字符数组。

创建一个WebOptions.对象,并设置其内容类型'文本'。这韦布雷德函数的作用是:将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的更多信息,以及世界银行:使用条款。)

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

使用a指定所请求图像的日期约会时间目的。指定格式的属性D使格式与web服务所需的格式相匹配。

URL =.'http://neowms.sci.gsfc.nasa.gov/wms/wms';01 D = datetime(2004年,12日,'格式','yyyy-mm-dd');rgb = webread (url,“时间”,d,......“服务”,'WMS',“层”,'bluemarbleng-tb','crs','CRS:84',......'格式','图像/ jpeg','高度', 256,'宽度'512,......“BBOX”,'-180.0,-90.0,180.0,90.0',“版本”,'1.3.0','要求','getmap');imshow (rgb)

韦布雷德转换约会时间对象使它们可以是Web服务查询参数的值。示例中的所有名称 - 值对提供了Neo Web映射服务指定的查询参数。

蓝色大理石:下一代+地形和沐浴般的图像由美国宇航局的地球天文台提供。访问Neo Web Mapping Service(WMS)提供的图像和服务。(见美国宇航局地球观察信贷和使用条款。对于WMS查询参数,请搜索NASA地球观测站点,WMS 1.3.0能力。)

输入参数

全部收缩

向Web服务的URL指定为字符向量或字符串标量。Web服务实现RESTful接口。看到宁静的欲获得更多信息。

例子:WebRead('https://www.mathwands.com/matlabcentral')读取网页并将其HTML返回为字符数组。

Web服务查询参数,指定为一个或多个名称-值参数对。一个QueryName参数必须指定查询参数的名称,作为字符向量或字符串标量。一个QueryValue.参数必须是字符向量,字符串标量或数字,逻辑或约会时间指定查询参数值的值。数字,逻辑和约会时间值可以在数组中。web服务定义了它作为请求的一部分接受的名称-值对。

当您指定时QueryValue.作为一个约会时间对象时,必须指定其格式属性使其与Web服务所需的格式一致。如果是格式属性包括时区或偏移量,以及约会时间对象没有被分区韦布雷德指定'当地的'作为时区。

什么时候QueryValue.包含数组中的多个值,您可能需要指定ArrayFormat.财产的WebOptions.对象以形成Web服务指定的阵列。

例子:webread(“//www.tatmou.com/matlabcentral/fileexchange/”,“词”,“webread”)检索上传到包含单词的文件交换的文件列表韦布雷德

其他HTTP请求选项,指定为aWebOptions.目的。

您可以指定内容类型财产的WebOptions.对象,并将对象作为输入参数传递给韦布雷德。然后韦布雷德返回数据作为该类型的输出。表列出了您可以在a中指定的有效内容类型WebOptions.目的。

内容类型说明书

输出类型

“汽车”(默认)

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

'文本'

内容类型的字符矢量:

文字/平原
text / html
text / xml
应用程序/ XML
应用程序/ javascript.
应用程序/ x-javascript
Application / X-WWW-Form-Urlencoded

如果web服务返回MATLAB®文件与A.。m扩展名,该函数将其内容返回为字符向量。

'图像'

数字或逻辑矩阵图像/格式内容。如果第一个输出参数是索引图像,则第二个输出参数是ColorMap,第三个输出参数是alpha通道。

有关支持金宝app的图像格式,请参见金宝app支持的导入和导出的文件格式

'声音的'

数字矩阵音频/格式第二个输出参数包含数值标量采样率。

有关支持金宝app的音频格式,请参见金宝app支持的导入和导出的文件格式

'二进制'

uint8.二进制内容的列向量(即,内容不被视为类型char)。

'桌子'

电子表格和CSV的标量表对象(文字/ CSV) 内容。

json的

char的数字、逻辑、结构或单元格数组应用/ JSON.内容。

'xmldom'

java.®文档对象模型(DOM)节点text / xml或者应用程序/ XML内容。如果未指定,则该函数将XML内容作为字符向量返回。

'生的'

char列向量'文本','xmldom', 和json的内容。该函数将任何其他内容类型返回为auint8.列向量。

看到WebOptions.适用于所有请求选项WebOptions.特性。

输出参数

全部收缩

从web服务读取的内容,作为标量、数组、结构或表返回。

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

与索引图像关联的alpha通道,返回为数字数组。

音频数据的采样率(以赫兹为单位),作为正数值标量返回。

更多关于

全部收缩

宁静的

休息方法代表国转,用于Web服务的常见架构风格。RESTful接口提供标准的HTTP方法,例如GET,PUT,POST或DELETE。

尖端

  • 对于不支持恢复的Web服务功能的功能,请参阅金宝appHTTP接口

  • 韦布雷德金宝app支持HTTP GET和POST方法。许多web服务同时提供GET和POST方法来请求数据。要发送HTTP POST请求,请指定RequestMethod的属性选项作为'邮政'。然而,韦布雷德将查询选项放入其中URL.,而不是在请求消息体中。要将查询放入正文中,请使用WebWrite.

  • 对于HTTP POST请求,韦布雷德功能仅支持金宝appApplication / X-WWW-Form-Urlencoded媒体类型。若要发送带有任何其他internet媒体类型内容的POST请求,请使用WebWrite.

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

在R2014B中介绍