data


URI

  1. <datas_uri>/{dataName}[.<format>]

  2. <datas_uri>/{dataIndex}[.<format>]

 

Supported methods

GET, HEAD

Parent resource

datas

Child resources

clearCache, modelIndex, config, tileDataVersion, tileData

Introduction

The data resource is a 3D data resource representing a specific 3D dataset (i.e., dataName). Currently, 3D data in SuperMap iServer include: vector data, image data, terrain data, 3D model data, and KML data. tileData resource can be used to retrieve a certain tile of the cached files of all the above data except for KML data, for which the dataset itself is retrieved by tileData resource.

The modelIndex child resource is a special child resource for cached 3D model data. It can be used to retrieve the model index.

Note: The concepts of index, configuration file, and data version are not applicable for KML data. Therefore the tileDataVersionchild resource is not meaningful to KML data. The config child resource can only retrieve the KML dataset itself.

 

Supported methods

Supported output formats: RJSONJSON, JSONP, HTML, XML.

GIS Services Resource Hierarchy

root realspace datas data

HTTP request methods

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; and OlympicGreen is the name of the 3D dataset, i.e., dataName.

http://supermapiserver:8090/iserver/services/3D-sample/rest/realspace/datas/OlympicGreen.rjson

GET Request

Gets the representation of a 3D dataset.

Request parameters

Field Type Definition
_cache boolean [Optional parameters]
Whether to use cache, the default is True. False means close all the cache.

Response structure

After a GET request is performed on the data resource, the representation of the 3D dataset is returned with the following structure (the resource representation is included in the entity body of the response message):   

Name Type Description
dataName String The name of the 3D dataset.
dataType realspaceDataType The type of the 3D dataset.

Example usage

Performing a GET request on the example data resource returns the representation of 3D dataset OlympicGreen, as shown below:

{

    "dataName": "OlympicGreen",

    "dataType": "VECTOR"

}

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 dataset resource exists, or if the data resource can be accessed by clients. It can also determine if the data resource supports an output format <format> if performed on a URI with .<format> included.

See