/version/index/{nCol}/{nRow}[.<format>]
The tileDataVersions resource can be used to identify the version of a certain tile of cache data (tile data) in a cached 3D dataset based on index, through performing a GET request on the resource.
Note: The concept of cache file and version are not applicable for KML data. Thus the tileDataVersion resource is not meaningful to KML data.
Supported methods
Supported output formats: RJSONJSON, JSONP, HTML, XML.
Below is an example of performing an HTTP request on a URI with rjson as the output format. In the URI: supermapiserver is the name of the server; WorldMap {dataName} is the 3D data layer; the first 1 is the column number (nCol); and the second 1 is the row number (nRow).
http://supermapiserver:8090/iserver/services/3D-sample/rest/realspace/datas/WorldMap/version/index/1/1?level=1&fileExtension=png
Gets the version of the tile data.
Proper parameters need to be included in the URI when performing a GET request on the tileDataVersion resource. The parameters that must be passed before "?" are as follows:
| Field | Type | Definition |
| nCol | int | The column number of the tile for the cache file in the global subdivision grid. |
| nRow | int | The row number of the tile for the cache file in the global subdivision grid. |
The parameters after "?" are all optional and listed as follows:
| Field | Type | Definition |
| level | int | The level of the data slice.(Only applicable for model data) |
| fileExtension | String | The file extension of the tile data. (See: Tile data file extension) |
| userName | String | The user name. |
| userPassword | String | The user password. |
| serviceVersion | String | The service version. |
| _cache | boolean | Whether to use cache, the default is True. False means close all the cache. |
After performing a GET request on the tileDataVersion resource, the server returns a response containing a string indicating the version.
The URI below is for performing a GET request on an example tileDataVersion resource, with parameters level and fileExtension:
http://supermapiserver:8090/iserver/services/3D-sample/rest/realspace/datas/WorldMap/version/index/1/1?level=1&fileExtension=png
A string in rjson format is returned indicating the version of the tile data, as shown below:
0000
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 tileDataVersion resource exists, or if the resource can be accessed by clients. It can also determine if the tileData resource supports an output format <format> if performed on a URI with .<format> included.