URI

<vectorMap_uri>/v2/mapserver/vmap/{serverName}/getMap[.<format>]

Here, serverName is the value of the "service name" parameter defined during service publishing. If not set, it will be the default service name generated by iServer.

Supported Methods

GET、HEAD

Parent Resource

vectorMap

Introduction

The getMap resource supports returning raster tile data that has been pre-cached and rasterized from vector tiles according to a style in the Vectortiles Service V2. The raster tile data is divided into square raster images of the same size, 512x512 pixels.

This interface can cover the capability of outputting raster tiles by style in the JW vector tiles service.

Supported methods:

  • GET: Obtain the raster map image for the specified tile level, row number, column number, and style.
  • HEAD: Obtain the metadata information of the getMap resource. Check whether the getMap resource exists and whether the permission is accessible.

Supported output formats: PNG.

HTTP Request Method

Perform an HTTP request on the following URI, taking the png output format as an example for illustration, where supermapiserver is the server name.

http://supermapiserver:8090/iserver/services/vectorMap-DLTB-public/restjsr/v2/mapserver/vmap/DLTB/getMap.png?styleID=DLTB&x=2&y=1&l=3&tilesize=512

GET Request

Obtain the raster map image for the specified tile level, row number, column number, and style.

Request Parameters

The parameters supported by the GET request are as follows:

Name Type Description
styleID String [Required parameter] The style id of the vector tiles electronic map. Multiple styles can be provided for the same service.
x int [Required parameter] Tile row number.
y int [Required parameter] Tile column number.
l int [Required parameter] Tile level. When it's necessary to override the JW vector tile service, use this parameter. It cannot be set with the z parameter. When using this parameter to view data with 4490 or 4326 coordinate system, the tile level starts at 1.
z int [Required parameter] Tile level. It cannot be set with the l parameter. When using this parameter for map browsing, the tile level starts at 0. The z parameter has higher priority than l.
tilesize int Tile size, in pixels. The current version only supports 512.


Response Example

The request parameters are as follows:

http://supermapiserver:8090/iserver/services/vectorMap-DLTB-public/restjsr/v2/mapserver/vmap/DLTB/getMap.png?styleID=DLTB&x=2&y=1&l=3&tilesize=512

Then the raster map image with the style DLTB at the corresponding tile position (row 2, column 1, level 3) is returned.

    

HEAD Request

Returns the same HTTP response headers as the GET request, but without a response entity. It can obtain metadata information contained in the response message headers without transmitting the entire response content. The metadata information includes media type, character encoding, compression encoding, entity content length, etc.

The HEAD request can be used to determine whether the getMap resource exists, or whether the client has permission to access the getMap resource. By performing a HEAD request on the URI with .<format>, it can also quickly determine whether the getMap resource supports the <format> representation.

Related Topics