이 페이지의 최신 내용은 아직 번역되지 않았습니다. 최신 내용은 영문으로 볼 수 있습니다.

webread

RESTful 웹 서비스에서 콘텐츠 읽어 들이기

구문

data = webread(url)
data = webread(url,QueryName1,QueryValue1,...,QueryNameN,QueryValueN)
data = webread(___,options)
[data,colormap,alpha] = webread(___)
[data,Fs] = webread(___)

설명

예제

data = webread(url)url에서 지정한 웹 서비스에서 콘텐츠를 읽어 들이고 그 콘텐츠를 data에 반환합니다.

웹 서비스는 JSON, XML, 이미지 또는 텍스트와 같은 인터넷 미디어 유형으로 형식이 지정된 데이터를 반환하는 RESTful 항목을 제공합니다.

예제

data = webread(url,QueryName1,QueryValue1,...,QueryNameN,QueryValueN)은 쿼리 파라미터를 하나 이상의 이름-값 인수로 지정하여 url에 추가합니다. 메시지 본문에 쿼리를 삽입하려면 webwrite를 사용하십시오. 웹 서비스는 쿼리 파라미터를 정의합니다.

예제

data = webread(___,options)weboptions 객체 options에서 지정한 다른 HTTP 요청 옵션을 추가합니다. 이 구문은 위에 열거된 구문 중 하나의 입력 인수에 사용할 수 있습니다.

데이터를 특정 출력 유형으로 반환하려면 optionsContentType 속성을 지정하십시오.

함수로 콘텐츠를 읽어 들이려면 optionsContentReader 속성을 함수에 대한 핸들로 지정하십시오. 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에서 지원되는 경우, 오디오 데이터를 반환합니다. 지원되는 오디오 형식을 보려면 가져오기와 내보내기에 지원되는 파일 형식 항목을 참조하십시오.

예제

모두 축소

Hubble Heritage 웹 사이트에서 목성의 이미지를 읽어 들이고 표시합니다.

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)

NASA, ESA, Hubble Heritage 팀(STScI/AURA)에서 제공하는 목성 이미지입니다. (사용 약관을 보려면 Hubble Heritage 정보 센터를 참조하십시오.)

World Bank Climate Data API에서 미국에 대한 기온 데이터를 읽습니다. 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.yearS.data를 배열에 결합하고 배열을 플로팅합니다.

year = [S.year];
data = [S.data];
plot(year,data)
xlabel('Year');
ylabel('Temperature (Celsius)');
title('USA Average Temperatures')
axis tight

World Bank에서 제공하는 API와 데이터: Climate Data API. (World Bank: Climate Data API에서 API와 World Bank: 사용 약관에 대한 자세한 정보를 참조할 수 있습니다.)

File Exchange에서 최근 7일 내에 업로드되었고 Simulink®라는 단어를 포함하는 파일을 검색합니다.

쿼리 파라미터를 지정합니다. webread는 웹 서비스 쿼리 파라미터와 값을 URL에 추가합니다. File Exchange 웹 서비스가 term 쿼리 파라미터와 duration 쿼리 파라미터를 정의하며, webread 함수가 이를 정의하는 것은 아닙니다.

url = 'https://www.mathworks.com/matlabcentral/fileexchange/';
data = webread(url,'term','simulink','duration',7);

webread는 검색 결과 페이지에 대한 HTML을 문자형 배열로 반환합니다.

World Bank Climate Data API에서 데이터를 문자형 배열로 읽어오는 추가 요청 옵션을 지정합니다.

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}

World Bank에서 제공하는 API와 데이터: Climate Data API. (World Bank: Climate Data API에서 API와 World Bank: 사용 약관에 대한 자세한 정보를 참조할 수 있습니다.)

HTTP POST 요청을 보내어 File Exchange에서 최근 7일 내에 업로드되었고 Simulink라는 단어를 포함하는 파일을 검색합니다.

url = 'https://www.mathworks.com/matlabcentral/fileexchange/';
options = weboptions('RequestMethod','post');
data = webread(url,'term','simulink','duration',7,options);

많은 웹 서비스는 GET 외에도 데이터를 요청하기 위한 POST 메서드를 제공합니다.

NEO(NASA Earth Observation) 웹 매핑 서비스에서 제공하는 2004년 12월의 Blue Marble: Next Generation 이미지를 읽습니다.

datetime 객체를 사용하여 요청한 이미지의 날짜를 지정합니다. 형식이 웹 서비스에 필요한 형식과 일치하도록 DFormat 속성을 지정합니다.

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)

webreaddatetime 객체를 변환해 웹 서비스 쿼리 파라미터의 값이 되도록 합니다. 예제의 모든 이름-값 쌍은 NEO 웹 매핑 서비스에서 지정하는 쿼리 파라미터를 제공합니다.

NASA의 Earth Observatory에서 제공하는 Blue Marble: Next Generation + Topography and Bathymetry 이미지입니다. NEO 웹 매핑 서비스(WMS)에서 제공한 영상과 서비스에 액세스합니다. (자료 출처 및 사용 약관에 대해서는 NASA Earth Observations를 참조하십시오. WMS 쿼리 파라미터에 대해서는 NASA Earth Observations 사이트 WMS 1.3.0 Capabilities를 검색하십시오.)

입력 인수

모두 축소

웹 서비스에 대한 URL로, 문자형 배열로 지정됩니다. 웹 서비스는 RESTful 인터페이스를 구현합니다. 자세한 내용은 RESTful 항목을 참조하십시오.

예: webread('https://www.mathworks.com/matlabcentral')은 웹 페이지를 읽어 들이고 HTML을 문자형 배열로 반환합니다.

웹 서비스 쿼리 파라미터로, 하나 이상의 이름-값 쌍 인수로 지정됩니다. QueryName 인수는 쿼리 파라미터의 이름을 지정해야 합니다. QueryValue 인수는 문자형 배열이거나 쿼리 파라미터의 값을 지정하는 숫자형, 논리형 또는 datetime형 값이어야 합니다. 숫자형, 논리형, datetime형 값이 배열에 들어 있을 수 있습니다. 웹 서비스는 요청의 일부로 받는 이름-값 쌍을 정의합니다.

QueryValuedatetime 객체로 지정하는 경우, 이것의 Format 속성을 웹 서비스에서 요구하는 형식과 일치하도록 지정해야 합니다. Format 속성이 표준 시간대나 오프셋을 포함하고, datetime 객체의 시간대가 지정되지 않은 경우, webread'Local'을 표준 시간대로 지정합니다.

QueryValue가 배열에 여러 개의 값을 포함할 경우, weboptions 객체의 ArrayFormat 속성을 지정하여 웹 서비스에서 지정한 대로 배열을 form-encode해야 할 수 있습니다.

예: webread('https://www.mathworks.com/matlabcentral/fileexchange/','term','webread')는 File Exchange에 업로드된 파일 중에서 webread라는 단어를 포함하는 파일의 목록을 검색합니다.

추가 HTTP 요청 옵션으로, weboptions 객체로 지정됩니다.

weboptions 객체의 ContentType 속성을 지정하고 그 객체를 webread에 입력 인수로 전달할 수 있습니다. 그러면 webreaddata를 출력 유형으로 반환합니다. 다음 표에 weboptions 객체에서 지정할 수 있는 올바른 콘텐츠 유형이 나열되어 있습니다.

ContentType 지정자

출력 유형

'auto'(디폴트 값)

출력 유형은 콘텐츠 유형을 기반으로 자동으로 지정됩니다.

'text'

아래 콘텐츠 유형에 대한 문자형 벡터:

text/plain
text/html
text/xml
application/xml
application/javascript
application/x-javascript
application/x-www-form-urlencoded

웹 서비스가 .m 확장자를 가지는 MATLAB® 파일을 반환하는 경우, 함수는 파일의 내용을 문자형 벡터로 반환합니다.

'image'

image/format 콘텐츠에 대한 숫자형 행렬 또는 논리형 행렬. 첫 번째 출력 인수가 인덱스 이미지인 경우, 두 번째 출력 인수는 컬러맵이고 세 번째 출력 인수는 알파 채널입니다.

지원되는 이미지 형식을 보려면 가져오기와 내보내기에 지원되는 파일 형식 항목을 참조하십시오.

'audio'

숫자형 스칼라 샘플링 레이트를 두 번째 출력 인수로 포함하는 audio/format 콘텐츠에 대한 숫자형 행렬.

지원되는 오디오 형식을 보려면 가져오기와 내보내기에 지원되는 파일 형식 항목을 참조하십시오.

'binary'

이진 콘텐츠(즉, char형으로 취급되지 않는 콘텐츠)에 대한 uint8형 열 벡터.

'table'

스프레드시트 및 CSV(text/csv) 콘텐츠에 대한 스칼라 테이블 객체.

'json'

application/json 콘텐츠에 대한 char형, 숫자형, 논리형, 구조체 또는 셀형 배열.

'xmldom'

text/xml 또는 application/xml 콘텐츠에 대한 Java® DOM(문서 객체 모델) 노드. 지정하지 않는 경우, 함수는 XML 콘텐츠를 문자형 벡터로 반환합니다.

'raw'

'text', 'xmldom', 'json' 콘텐츠에 대한 char 열 벡터. 함수는 그 밖의 콘텐츠 유형을 uint8형 열 벡터로 반환합니다.

weboptions 속성에 해당하는 모든 요청 옵션을 보려면 weboptions를 참조하십시오.

출력 인수

모두 축소

웹 서비스에서 읽은 콘텐츠로, 스칼라, 배열, 구조체, 테이블 중 하나로 반환됩니다.

인덱스 이미지와 연결된 컬러맵으로, 숫자형 배열로 반환됩니다.

인덱스 이미지와 연결된 알파 채널로, 숫자형 배열로 반환됩니다.

오디오 데이터의 샘플 레이트(단위: 헤르츠)로, 양의 숫자형 스칼라로 반환됩니다.

세부 정보

모두 축소

RESTful

RESTREpresentational State Transfer 즉, 웹 서비스에 대한 공통된 구조적 스타일을 의미합니다. RESTful 인터페이스는 GET, PUT, POST 또는 DELETE와 같은 표준 HTTP 메서드를 제공합니다.

  • RESTful 웹 서비스 기능에서 지원하지 않는 기능에 대해서는 HTTP 인터페이스 항목을 참조하십시오.

  • webread는 HTTP GET 메서드와 POST 메서드를 지원합니다. 많은 웹 서비스는 GET 메서드와 POST 메서드를 모두 제공하여 데이터를 요청합니다. HTTP POST 요청을 보내려면 optionsRequestMethod 속성을 'post'로 지정하십시오. 하지만 webread는 쿼리 옵션을 요청 메시지의 본문이 아니라 url에 삽입합니다. 쿼리를 본문에 삽입하려면 webwrite를 사용하십시오.

  • HTTP POST 요청의 경우, webread 함수는 application/x-www-form-urlencoded 미디어 유형만 지원합니다. 다른 인터넷 미디어 유형의 콘텐츠와 함께 POST 요청을 보내려면 webwrite를 사용하십시오.

  • 이 함수는 처리 방법을 결정하기 위해 문서 내용을 검토하지 않습니다. 예를 들어, HTML 문서와 XML 문서에는 문서의 문자 인코딩을 지정하는 <meta> 태그가 포함되는 경우가 많습니다. 인코딩이 디폴트 webread 인코딩과 다를 경우 weboptions에서 올바른 CharacterEncoding 옵션을 지정하십시오.

R2014b에 개발됨