URI
<vectorMap_uri>/v2/mapserver/serverInfo/{serverName}[.<format>]
Supported Methods
Parent Resource
Introduction
Provides information about raster rendering services in the Vectortiles Service V2, such as tile origin, bounds, scales, used data and filtering conditions.
This API can cover the corresponding capabilities of the JW vector tiles service.
Supported Methods:
- GET: Get information about raster rendering services in the Vectortiles Service V2.
- HEAD: Check whether the serverInfo resource exists and whether the permission is accessible.
Supported Representation Formats: RJSON, JSON, JSONP.
HTTP Request Methods
Perform an HTTP request on the following URI, taking JSON output format as an example. Here, supermapiserver is the server name, {component} is the component name, and {serverName} is the "service name" defined during service publishing (If not set, it will be the default service name generated by iServer).
http://supermapiserver:8090/iserver/services/{component}/restjsr/v2/mapserver/serverInfo/{serverName}.json
GET Request
Get information about raster rendering services in the Vectortiles Service V2, including tile origin, bounds, scales, used data and filtering conditions.
Response Structure
Executing a GET request on the serverInfo resource returns the resource representation structure as follows:
| Field | Type | Description |
| id | string | Service identifier ID, example value: word |
| serviceType | string | Service type, fixed as vector_service (vector service) |
| vectorCachedLevels | string | Exisiting vector cache levels, separated by commas. |
| imageCachedLevels | object | The level of raster cache that exists, with each level represented as a style. The key is the style ID, and the value is the level of raster cacge present in the cache folder. The value is of string type, and the levels are sepereate by coomas. For example：{"DLTB": { "P_256_1431900458": "4,6,7,8,9,10"} |
| layerMap | object | Layer configuration mapping collection, key is the layer ID |
| dataSetMap | object | Dataset configuration mapping collection, key is the dataset ID |
| gridTreeName | string | Tile grid tree name, example: tdt_degree_base512 |
| gridType | string | Tile grid type |
| gridUnit | string | Grid unit |
| gridBase | string | Tile base specification, base512 (512-pixel tiles) |
| grid | object | Tile grid detailed configuration |
| version | string | Service type version number (timestamp format) |
| origin | array[] | Tile origin coordinates |
| srid | number | Spatial reference system EPSG code, e.g., 4326 |
| resolutions | array[] | Resolutions at each tile level, i.e., scale information |
| cacheLayerMap | object | Cache layer mapping, empty object indicates no cache configuration |
| bbox | string | Service global geographic extent, separated by "," |
Response Structure of layerMap
| Field | Type | Description |
| idFieldType | string | Feature ID field data type |
| layerType | string | Layer type, fixed as VECTOR (vector layer) |
| idField | string | Feature unique identifier field name |
| beginLevel | number | Layer start display level |
| labelOnly | boolean | Whether it is label-only mode, false means vector + label |
| levelMap | object | Configuration mapping for each zoom level, key is the level number |
| endLevel | number | Layer end display level |
| haveLabel | boolean | Whether labels are enabled, false means not enabled |
| id | string | Layer ID |
| fields | array[] | Layer attribute field collection |
| cutOutScreen | boolean | Whether screen clipping is enabled, true means enabled |
| geometryType | string | Feature geometry type |
Response Structure of layerMap-levelMap
| Field | Type | Description |
| filterSQL | string | Level feature filter SQL statement, empty means no filter |
| virtual | boolean | Whether it is a virtual level, false means real tile level |
| dataSetId | string | Bound dataset ID |
| level | int | Current tile level number |
| simplifyForLayerLevel | int | Level feature simplification coefficient, 0 means no simplification |
Response Structure of layerMap-fields
| Field | Type | Description |
| id | boolean | Whether it is the primary key ID field, true means primary key |
| index | int | Field index number |
| name | string | Field English name |
| type | string | Field data type |
Response Structure of datasetMap
| Field | Type | Description |
| filter | string | Dataset global filter condition, empty means no filter |
| dataServiceId | string | Bound data service unique ID |
| bbox | string | Geographic extent corresponding to the dataset |
| id | string | Dataset ID |
Response Structure of grid
| Field | Type | Description |
| maxLevel | number | Maximum tile level |
| base | number | Tile base pixels, 512 |
| unit | string | Grid unit |
| resolutionLevelBegin | number | Scale start level |
| minX | number | Grid minimum longitude |
| minY | number | Grid minimum latitude |
| maxX | number | Grid maximum longitude |
| maxY | number | Grid maximum latitude |
| beginLevel | number | Grid effective start level |
| type | string | Tile type |
| name | string | Grid name |
| resolutions | array[] | Array of tile resolutions at each scale level |
Response Example
Execute a GET request on the serverInfo resource: http://supermapiserver:8090/iserver/services/vectorMap-DLTB-public/restjsr/v2/mapserver/serverInfo/DLTB.json, returning the JSON format resource representation as follows:
{
"serviceType": "vector_service",
"imageCachedLevels": {
"DLTB": {
"P_256_1431900458": "4,5"
},
"vectorCachedLevels": "4,5,6,7",
"origin": [
-180,
90
],
"bbox": "109.41607750300243,22.617793848072214,110.47650761500358,23.48064438917779",
"resolutions": [
0.703125,
0.3515625,
0.17578125,
0.087890625,
0.0439453125,
0.02197265625,
0.010986328125,
0.0054931640625,
0.00274658203125,
0.001373291015625,
0.0006866455078125,
0.00034332275390625,
0.000171661376953125,
0.0000858306884765625,
0.00004291534423828125,
0.000021457672119140625,
0.000010728836059570312,
0.000005364418029785156,
0.000002682209014892578,
0.000001341104507446289,
6.705522537231445e-7,
3.3527612686157227e-7,
1.6763806343078613e-7,
8.381903171539307e-8,
4.190951585769653e-8,
2.0954757928848267e-8
],
"version": null,
"gridTreeName": "tdt_degree_base512",
"dataSetMap": {
"dltb40w_4326": {
"filter": null,
"dataServiceId": null,
"bbox": "109.41607750300243,22.617793848072214,110.47650761500358,23.48064438917779",
"id": "dltb40w_4326"
}
},
"srid": 4326,
"layerMap": {
"dltb40w_4326": {
"idFieldType": "integer",
"idField": "smid",
"layerType": "VECTOR",
"beginLevel": 1,
"labelOnly": false,
"haveLabel": false,
"levelMap": {
"1": {
"filterSQL": "",
"virtual": false,
"dataSetId": "dltb40w_4326",
"level": 1,
"simplifyForLayerLevel": 0
},
"2": {
"filterSQL": "",
"virtual": false,
"dataSetId": "dltb40w_4326",
"level": 2,
"simplifyForLayerLevel": 0
},
"3": {
"filterSQL": "",
"virtual": false,
"dataSetId": "dltb40w_4326",
"level": 3,
"simplifyForLayerLevel": 0
},
"4": {
"filterSQL": "",
"virtual": false,
"dataSetId": "dltb40w_4326",
"level": 4,
"simplifyForLayerLevel": 0
},
"5": {
"filterSQL": "",
"virtual": false,
"dataSetId": "dltb40w_4326",
"level": 5,
"simplifyForLayerLevel": 0
},
"6": {
"filterSQL": "",
"virtual": false,
"dataSetId": "dltb40w_4326",
"level": 6,
"simplifyForLayerLevel": 0
},
"7": {
"filterSQL": "",
"virtual": false,
"dataSetId": "dltb40w_4326",
"level": 7,
"simplifyForLayerLevel": 0
},
"8": {
"filterSQL": "",
"virtual": false,
"dataSetId": "dltb40w_4326",
"level": 8,
"simplifyForLayerLevel": 0
},
"9": {
"filterSQL": "",
"virtual": false,
"dataSetId": "dltb40w_4326",
"level": 9,
"simplifyForLayerLevel": 0
},
"10": {
"filterSQL": "",
"virtual": false,
"dataSetId": "dltb40w_4326",
"level": 10,
"simplifyForLayerLevel": 0
},
"11": {
"filterSQL": "",
"virtual": false,
"dataSetId": "dltb40w_4326",
"level": 11,
"simplifyForLayerLevel": 0
},
"12": {
"filterSQL": "",
"virtual": false,
"dataSetId": "dltb40w_4326",
"level": 12,
"simplifyForLayerLevel": 0
},
"13": {
"filterSQL": "",
"virtual": false,
"dataSetId": "dltb40w_4326",
"level": 13,
"simplifyForLayerLevel": 0
},
"14": {
"filterSQL": "",
"virtual": false,
"dataSetId": "dltb40w_4326",
"level": 14,
"simplifyForLayerLevel": 0
},
"15": {
"filterSQL": "",
"virtual": false,
"dataSetId": "dltb40w_4326",
"level": 15,
"simplifyForLayerLevel": 0
},
"16": {
"filterSQL": "",
"virtual": false,
"dataSetId": "dltb40w_4326",
"level": 16,
"simplifyForLayerLevel": 0
},
"17": {
"filterSQL": "",
"virtual": false,
"dataSetId": "dltb40w_4326",
"level": 17,
"simplifyForLayerLevel": 0
},
"18": {
"filterSQL": "",
"virtual": false,
"dataSetId": "dltb40w_4326",
"level": 18,
"simplifyForLayerLevel": 0
},
"19": {
"filterSQL": "",
"virtual": false,
"dataSetId": "dltb40w_4326",
"level": 19,
"simplifyForLayerLevel": 0
},
"20": {
"filterSQL": "",
"virtual": false,
"dataSetId": "dltb40w_4326",
"level": 20,
"simplifyForLayerLevel": 0
},
"21": {
"filterSQL": "",
"virtual": false,
"dataSetId": "dltb40w_4326",
"level": 21,
"simplifyForLayerLevel": 0
},
"22": {
"filterSQL": "",
"virtual": false,
"dataSetId": "dltb40w_4326",
"level": 22,
"simplifyForLayerLevel": 0
},
"23": {
"filterSQL": "",
"virtual": false,
"dataSetId": "dltb40w_4326",
"level": 23,
"simplifyForLayerLevel": 0
},
"24": {
"filterSQL": "",
"virtual": false,
"dataSetId": "dltb40w_4326",
"level": 24,
"simplifyForLayerLevel": 0
},
"25": {
"filterSQL": "",
"virtual": false,
"dataSetId": "dltb40w_4326",
"level": 25,
"simplifyForLayerLevel": 0
},
"26": {
"filterSQL": "",
"virtual": false,
"dataSetId": "dltb40w_4326",
"level": 26,
"simplifyForLayerLevel": 0
},
"27": {
"filterSQL": "",
"virtual": false,
"dataSetId": "dltb40w_4326",
"level": 27,
"simplifyForLayerLevel": 0
},
"28": {
"filterSQL": "",
"virtual": false,
"dataSetId": "dltb40w_4326",
"level": 28,
"simplifyForLayerLevel": 0
},
"29": {
"filterSQL": "",
"virtual": false,
"dataSetId": "dltb40w_4326",
"level": 29,
"simplifyForLayerLevel": 0
},
"30": {
"filterSQL": "",
"virtual": false,
"dataSetId": "dltb40w_4326",
"level": 30,
"simplifyForLayerLevel": 0
}
},
"id": "dltb40w_4326",
"fields": [
{
"name": "SmID",
"index": 0,
"id": false,
"type": "integer"
},
{
"name": "smuserid",
"index": 0,
"id": false,
"type": "integer"
},
{
"name": "smarea",
"index": 0,
"id": false,
"type": "double"
},
{
"name": "smperimeter",
"index": 0,
"id": false,
"type": "double"
},
{
"name": "smgeometry",
"index": 0,
"id": false,
"type": "bytes"
},
{
"name": "smgeoparam",
"index": 0,
"id": false,
"type": "bytes"
},
{
"name": "tbbh",
"index": 0,
"id": false,
"type": "string"
},
{
"name": "dlbm",
"index": 0,
"id": false,
"type": "string"
},
{
"name": "dlmc",
"index": 0,
"id": false,
"type": "string"
},
{
"name": "gdlx",
"index": 0,
"id": false,
"type": "string"
},
{
"name": "dlbz",
"index": 0,
"id": false,
"type": "string"
},
{
"name": "gdpdj",
"index": 0,
"id": false,
"type": "string"
},
{
"name": "xzdwmj",
"index": 0,
"id": false,
"type": "double"
}
],
"cutOutScreen": true,
"endLevel": 30,
"geometryType": "MULTIPOLYGON"
}
},
"gridType": "tdt",
"grid": {
"maxLevel": 30,
"unit": "degree",
"beginLevel": 2,
"minY": -90,
"minX": -180,
"maxY": 90,
"maxX": 180,
"name": "degree512esri",
"resolutions": [
0.703125,
0.3515625,
0.17578125,
0.087890625,
0.0439453125,
0.02197265625,
0.010986328125,
0.0054931640625,
0.00274658203125,
0.001373291015625,
0.0006866455078125,
0.00034332275390625,
0.000171661376953125,
0.0000858306884765625,
0.00004291534423828125,
0.000021457672119140625,
0.000010728836059570312,
0.000005364418029785156,
0.000002682209014892578,
0.000001341104507446289,
6.705522537231445e-7,
3.3527612686157227e-7,
1.6763806343078613e-7,
8.381903171539307e-8,
4.190951585769653e-8,
2.0954757928848267e-8,
1.0477378964424133e-8,
5.238689482212067e-9,
2.6193447411060333e-9,
1.3096723705530167e-9,
0
],
"resolutionLevelBegin": 0,
"type": "esri",
"base": 512
},
"id": "DLTB",
"cacheLayerMap": null,
"gridBase": "base512",
"gridUnit": "degree"
}
HEAD Request
Returns the same HTTP response headers as a GET request, but without a response body. It can obtain meta data information contained in the response message headers without transferring the entire response content. Meta data information includes media type, character encoding, compression encoding, entity content length, etc.
The HEAD request can be used to determine whether the serverInfo resource exists, or whether the client has permission to access the serverInfo resource. By executing a HEAD request on the URI with .<format>, it can also quickly determine whether the serverInfo resource supports representations in the <format> format.
See Also
- vectorMap
- Construct REST Request from Client
- List and Description of Status Codes
- SuperMap iServer REST API Representation Format Introduction