tileStorage

URI

<tileStorages uri>/{storageID}[.<format>]

Supported methods

GET, DELETE, HEAD

Parent resource

tileStorages

Introduction

The tile storage resource. You can get the storage configuration information and tile set list information of the specified storage resource through the GET request. You can also delete the specified tile storage information through the DELETE request.

Supported Methods:

Supported output formats: rjson, json, html, xml.

Resource hierarchy

HTTP request methods

Implement the HTTP request on the following URI, where supermapiserver is the server name, with rjson being the output format.

http://supermapiserver:8090/iserver/manager/storages/{storageID}.rjson

GET request

Gets the storage configuration information and tile set list information. The request parameters must be placed in the URI.

Request parameter

Name Type Description

tilesetFromIndex

 String [Optional]
Returns the starting index of the tile set query result.

tilesetToIndex

 String [Optional]
Returns the ending index of the tile set query result. For example, tilesetFromIndex=0&tilesetToIndex=3 represents only the first 3 tile set will display in the tile set list of the current page. If the two parameters not set, all tile sets will display.

Response structure

The returned resource representation structure is as follows if implementing GET request on the tileStorage resource (resource representation is in the entity body of the response message):

Field Type Description
currentCount int The number of tile sets displayed in the tile set list of the current page.
id String The tile storage ID.
tileSourceInfo TileSourceInfo The tile storage source information.
tilesetInfos TilesetInfo[] The tile set information list.
totalCount int The total number of tile sets.

Response example

The returned rjson format representation after implementing the GET request on the tileStorage resource http://localhost:8090/iserver/manager/storages/aa.rjson?tilesetFromIndex=0&tilesetToIndex=3 is as follows:

DELETE request

Deletes the specified tile storage information.

Response structure

The returned representation structure is as follows after implementing the DELETE request on the tileStorage resource (representation is in the entity body of the response message):

Field Type Description
succeed boolean Whether the current tile storage information has been successfully deleted.

 

Response example

 Suppose we implement the the DELETE request on the tileStorage resource http://localhost:8090/iserver/manager/storages/aa.rjson to delete the tile storage information with id "aa", the returned rjson format response result is as follows:

{"succeed": true}

HEAD request

Asks for the response identical to the one that would correspond to a GET request, but without the response body. This is useful for retrieving meta-information written in response headers, without having to transport the entire content. The meta-information includes the media-type, content-encoding, transfer-encoding, content-length, etc.

HEAD request can be used to check if the tileStorage resource exists, or if the tileStorage resource can be accessed by clients. It can also determine if the tileStorage resource supports an output format <format> if performed on a URI with .<format> included.

See