URI
<tiles_uri>/datas/{dataID}[.<format>]
Supported methods
Parent resource
Introduction
The data resource represents a data package. By sending GET request to data resource, you can get cache tiles description information. By sending DELETE request to delete this data. Supported Methods:
- GET: Get data description of data package.
- DELETE: Delete data package.
- HEAD: Check whether the data resource exists or whether there is a permission to access the resource.
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/services/datacatalog/rest/datacatalog/tiles/datas/{dataID}.rjson
GET request
Gets data description information of data package.
Request parameter
Performing GET request on data resource, the description information of the cached tiles data will be returned. The representation structure is as follows:
| Field | Type | Description |
| createTime | Date | Imported time of data package. |
| dataId | String | data ID. |
| metaData | ImageMetaData | |
| targetServiceInfos | List<TargetServiceInfo> | |
| tilesSourceInfo | TileSourceInfo | titles collection information. including storage type, storage location, etc. |
| tilesetName | String | tiles collection name. |
| type | DataType | data type. |
Response example
Perform GET request on sample data resource: http://supermapiserver:8090/iserver/services/datacatalog/rest/datacatalog/tiles/datas/9accb6389acc9db1fa31e6dec77b3e8b_ffa2a25b_f46d_47f5_8df2_185c0b86a0f4.rjson, the returned resource represenation in rjson format is as follows:
{
"createTime": {
"date": 12,
"hours": 14,
"minutes": 53,
"month": 8,
"seconds": 53,
"time": 1505199233352,
"year": 117
},
"dataId": "9accb6389acc9db1fa31e6dec77b3e8b_ffa2a25b_f46d_47f5_8df2_185c0b86a0f4",
"metaData": {
"bounds": {
"bottom": -2.003750834278914E7,
"left": -2.0037508342789248E7,
"leftBottom": {
"x": -2.0037508342789248E7,
"y": -2.003750834278914E7
},
"right": 2.0037508342789244E7,
"rightTop": {
"x": 2.0037508342789244E7,
"y": 2.0037508342789087E7
},
"top": 2.0037508342789087E7
},
"mapName": "China",
"mapParameter": null,
"mapStatusHashCode": "-1675928624",
"originalPoint": {
"x": -2.0037508342789248E7,
"y": 2.0037508342789087E7
},
"prjCoordSys": {
"coordSystem": {
"datum": {
"name": "D_WGS_1984",
"spheroid": {
"axis": 6378137,
"flatten": 0.00335281066474748,
"name": "WGS_1984",
"type": "SPHEROID_WGS_1984"
},
"type": "DATUM_WGS_1984"
},
"name": "GCS_WGS_1984",
"primeMeridian": {
"longitudeValue": 0,
"name": "Greenwich",
"type": "PRIMEMERIDIAN_GREENWICH"
},
"spatialRefType": "SPATIALREF_EARTH_LONGITUDE_LATITUDE",
"type": "GCS_WGS_1984",
"unit": "DEGREE"
},
"coordUnit": "METER",
"distanceUnit": "METER",
"epsgCode": 3857,
"name": "User Define",
"projection": {
"name": "SPHERE_MERCATOR",
"type": "PRJ_SPHERE_MERCATOR"
},
"projectionParam": {
"azimuth": 0,
"centralMeridian": 0,
"centralParallel": 0,
"falseEasting": 0,
"falseNorthing": 0,
"firstPointLongitude": 0,
"firstStandardParallel": 0,
"rectifiedAngle": 0,
"scaleFactor": 1,
"secondPointLongitude": 0,
"secondStandardParallel": 0
},
"type": "PCS_USER_DEFINED"
},
"resolutions": [
156543.03393,
78271.516964,
39135.758482,
19567.879241,
9783.9396205,
4891.9698103,
2445.9849051
],
"scaleDenominators": [
5.916587109091312E8,
2.9582935545456564E8,
1.4791467772728282E8,
7.395733886364141E7,
3.6978669431820706E7,
1.8489334715910353E7,
9244667.357955176
],
"tileFormat": "PNG",
"tileHeight": 256,
"tileRuleVersion": "1.0",
"tileType": "Image",
"tileWidth": 256,
"transparent": false
},
"targetServiceInfos": null,
"tileSourceInfo": {
"database": "supermap",
"datastoreType": "TILES",
"password": null,
"serverAdresses": ["192.168.112.100:27017"],
"type": "MongoDB",
"username": null
},
"tilesetName": "1181328118",
"type": "SMTILES"
}
DELETE request
Delete cached data of the specified tile which has been uploaded to the datastore.
Response structure
Perform DELETE request on data resource, the structure of the returned resource representation is as follows:
| Field | Type | Description |
| succeed | boolean | Deletion successes or fails? |
| error | HttpError | Error message. If the deletion successes, there is no this field. |
Response example
Perform DELETE request on data resouce: http://supermapiserver:8090/iserver/services/datacatalog/rest/datacatalog/tiles/datas/9accb6389acc9db1fa31e6dec77b3e8b_849d08d7_6b5e_4dd2_9131_76be1670684d.rjson , the returned resource description in rjson format 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 contained 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 whether the data resource exists, or whether the the client has the permission to access it. It can also determine if the data resource supports an output format <format> if performed on a URI with .<format> included.