Отображение мировой карты

Этот пример показывает, как получить доступ к формированию изображений от Геологической службы США (USGS) Национальная Карта сервер SOAP. Чтобы создать карту, вам нужна следующая информация.

Получите мозаику карты.
Получите имя карты.
Получите формат мозаик.

Этот пример показывает вам, как вызвать функции в веб-сервисе USGS, USGSImageryOnly_MapServer, чтобы получить эту информацию.

Установите ^{Java® JDK™} и программы Apache™ CXF и установите пути к инструменту, чтобы запустить этот пример.

p = matlab.wsdl.setWSDLToolPath;
if (isempty(p.JDK) || isempty(p.CXF))
    disp('Install the Java Development Kit (JDK) and Apache CXF programs.')
    disp('See the Set Up WSDL Tools link at the end of this example.')
else
    disp('Paths set to:')
    matlab.wsdl.setWSDLToolPath
end

Измените свою текущую папку на перезаписываемую папку.

Присвойте WSDL URL.

wsdlFile = ...
'http://basemap.nationalmap.gov/arcgis/services/USGSImageryOnly/MapServer?wsdl';

Создайте файлы класса для клиента.

matlab.wsdl.createWSDLClient(wsdlFile)

Created USGSImageryOnly_MapServer.
  .\USGSImageryOnly_MapServer.m
  .\+wsdl

In order to use USGSImageryOnly_MapServer, you must run javaaddpath('.\+wsdl\mapserver.jar').

ans = 

    @USGSImageryOnly_MapServer

Добавьте файлы банки к пути Java.

javaaddpath('.\+wsdl\mapserver.jar')

Запустите сервис.

wsdl = USGSImageryOnly_MapServer;

Исследуйте сервис.

help USGSImageryOnly_MapServer

USGSImageryOnly_MapServer   A client to connect to the USGSImageryOnly_MapServer service
     SERVICE = USGSImageryOnly_MapServer  connects to http://basemap.nationalmap.gov/arcgis/services/USGSImageryOnly/MapServer and returns a SERVICE.
     
     To communicate with the service, call a function on the SERVICE:
 
        [...] = FUNCTION(SERVICE,arg,...) 
 
     See doc USGSImageryOnly_MapServer for a list of functions.

Щелкните по ссылке doc USGSImageryOnly_MapServer. ^MATLAB® открывает страницу с описанием для USGSImageryOnly_MapServer в Браузере документации.

Считайте документацию для необходимых входных параметров к функции GetMapTile.

help GetMapTile

 --- help for USGSImageryOnly_MapServer/GetMapTile ---

 GetMapTile  
   Result = GetMapTile(obj,MapName,Level,Row,Column,Format)  
     Inputs:
       obj - USGSImageryOnly_MapServer object
       MapName - string
       Level - numeric scalar (XML int)
       Row - numeric scalar (XML int)
       Column - numeric scalar (XML int)
       Format - string
     Output:
       Result - vector of numbers 0-255 (XML base64Binary)
 
  See also USGSImageryOnly_MapServer.

Вам нужны MapName, Level, Row, Column и входные параметры Format.

Считайте документацию для функции, которая обеспечивает имя карты, GetDefaultMapName.

help GetDefaultMapName

--- help for USGSImageryOnly_MapServer/GetDefaultMapName ---

 GetDefaultMapName  
   Result = GetDefaultMapName(obj)  
     Inputs:
       obj - USGSImageryOnly_MapServer object
     Output:
       Result - string
 
  See also USGSImageryOnly_MapServer.

Эта функция обеспечивает имя карты.

Считайте документацию для функции, которая обеспечивает данные о формате карты, GetTileImageInfo.

help GetTileImageInfo

--- help for USGSImageryOnly_MapServer/GetTileImageInfo ---

 GetTileImageInfo  
   Result = GetTileImageInfo(obj,MapName)  
     Inputs:
       obj - USGSImageryOnly_MapServer object
       MapName - string
     Output:
       Result - TileImageInfo object
 
  See also USGSImageryOnly_MapServer.

Эта функция возвращает объект TileImageInfo.

Считайте документацию для объекта TileImageInfo путем щелчка по ссылке в отображении справки к TileImageInfo.

TileImageInfo(CacheTileFormat,CompressionQuality,Antialiasing)  TileImageInfo object for use with USGSImageryOnly_MapServer web client
 
      CacheTileFormat - string
          The cache tile format.
      CompressionQuality - numeric scalar (XML int)
          The cache tile image compression quality.
      Antialiasing - string
See also
USGSImageryOnly_MapServer.

MATLAB открывает документ в Браузере документации. Данными о формате является CacheTileFormat.

Создайте данные JPEG. Следующий код требует знания формата изображения JPEG и схемы мозаичного размещения, используемой сервером USGS.

% Get the default map name.
defaultMapName = GetDefaultMapName(wsdl);

% Get the map count.
count = GetMapCount(wsdl);

% Get the map name. There is only one map (count value),
% but the index is zero-based.
mapName = GetMapName(wsdl, count-1);

% Get information about the tiles.
tileImageInfo = GetTileImageInfo(wsdl, mapName);

% Get the format of the data.
format = tileImageInfo.CacheTileFormat;

% Since format is specified as 'Mixed' it implies that 
% the result of GetMapTile is a JPEG-encoded stream.
% The map tiles are organized with the lowest level as 
% the lowest level of detail and the tiles use 
% zero-based indexing.
level = 0; 
row = 0; 
col = 0; 
jpeg = GetMapTile(wsdl,mapName,level,row,col,format);

Запишите закодированные JPEG данные в файл. Используйте imread, чтобы считать и декодировать данные JPEG и возвратить M N 3 матрицами uint8.

ext = '.jpg'; 
tilename = ['USGSImageryOnly_MapServer' '0_0_0' ext]; 
fid = fopen(tilename,'w'); 
fwrite(fid,jpeg)
fclose(fid)

Просмотрите карту.

tileImage = imread(tilename);
figure
imshow(tileImage)

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

Отображение мировой карты

Похожие темы

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

Поддержка